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Foreword 

This  handbook  is  intended  to  assist  programmers  to  develop  software  for  use  with  IRIG 
106  standard  instrumentation  recorders.  This  handbook  primarily  addresses  IRIG  106  Chapter 
10  recorders,  but  also  covers  aspects  of  Chapter  6  and  Chapter  9. 

Task  Lead:  Mr.  James  P.  Ferrill 

Instrumentation  Division 
412  Test  Engineering  Group 
307  Popson  Dr. 

Edwards  AFB,  CA  93524 
E-Mail:  iames.ferrill.ctr@us.af.mil 

Please  direct  any  questions  to: 

Secretariat,  Range  Commanders  Council 
ATTN:  CSTE-WS-RCC 
1510  Headquarters  Avenue 

White  Sands  Missile  Range,  New  Mexico  88002-5110 
Telephone:  (575)  678-1107,  DSN  258-1107 
E-Mail:  usarmy.wsmr.atec.list.rcc@mail.mil 
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CHAPTER  1 
Scope 


1.1  General 

The  Telemetry  Group  (TG)  of  the  Range  Commanders  Council  (RCC)  has  developed  the 
Inter-Range  Instrumentation  Group  (IRIG)  106 1  standard  for  test  range  telemetry.  The  purpose 
of  IRIG  106  is  to  define  a  common  framework  for  test  range  instrumentation  primarily  to  ensure 
test  range  interoperability.  The  RCC  periodically  revises  and  reissues  IRIG  106.  A  specific 
version  of  IRIG  106  is  suffixed  with  the  last  two  digits  of  the  year  it  was  released.  For  example 
IRIG  106-07  refers  to  the  version  of  IRIG  106  released  in  2007. 

The  IRIG  106  is  composed  of  10  chapters,  each  devoted  to  a  different  element  of  the 
telemetry  system  or  process.  One  of  the  major  topics  of  the  IRIG  106  standard  is  Chapter  10,  the 
Digital  Recording  Standard.2  Chapter  10  defines  the  interfaces  and  operational  requirements  for 
digital  data  recording  devices.  Chapter  10  also  references  elements  of  Chapter  6,  Recorder  & 
Reproducer  Command  and  Control3,  and  Chapter  9,  Telemetry  Attributes  Transfer  Standard4 
(TMATS). 

Chapter  10  is  quite  comprehensive  in  its  scope.  The  purposes  of  this  handbook  are  to 
serve  as  an  adjunct  to  the  IRIG  106  standard  to  help  the  computer  programmer  write  software  for 
operating  IRIG  106  Chapter  10  standard  digital  recorders,  and  to  analyze  data  from  these 
recorders.  A  prior  working  knowledge  of  Chapters  9  and  10,  as  well  as  applicable  sections  of 
Chapter  6  is  essential. 

1.2  Document  Layout 

This  document  addresses  specific  topics  of  Chapters  6,  9,  and  10  important  to  the 
programmer.  Algorithms  and  data  structures  are  presented  to  assist  the  programmer  in  correctly 
interpreting  IRIG  106  and  implementing  software  for  use  with  digital  data  recorders.  In 
particular,  data  structures  are  defined  in  American  National  Standards  Institute  (ANSI)  C  for  data 
defined  in  IRIG  106.  Guidance  is  also  offered  on  specific  programming  techniques. 

Chapter  2  covers  reading  and  interpreting  Chapter  9  recorder  configuration  files. 

Chapter  3  covers  data  retrieval  over  the  standard  recorder  interfaces. 

Chapter  4  covers  recorder  command  and  control. 


1  Range  Commanders  Council.  Telemetry  Standards.  IRIG  106-15.  July  2015.  May  be  superseded  by  update. 
Retrieved  12  April  2016.  Available  at  http://www.wsmr, army, mil/RCCsite/Documents/106- 

15  Telemetry  Standards/. 

2  Range  Commanders  Council.  “Digital  Recording  Standard”  in  Telemetry  Standards.  IRIG  106-15  Chapter  10. 
May  be  superseded  by  update.  July  2015.  Retrieved  12  April  2016.  Available  at 
http://www.wsmr.armv.mil/RCCsite/Documents/106-15  Telemetry  Standards/chapter  10. pdf. 

3  Range  Commanders  Council.  “Recorder  &  Reproducer  Command  and  Control”  in  Telemetry  Standards.  IRIG 
106-15  Chapter  6.  May  be  superseded  by  update.  July2015.  Retrieved  12  April  2016.  Available  at 
http://www.wsmr.armv.mil/RCCsite/Documents/106-15  Telemetry  Standards/chap ter6.pdf. 

4  Range  Commanders  Council.  “Telemetry  Attributes  Transfer  Standard”  in  Telemetry  Standards.  IRIG  106-15 
Chapter  9.  May  be  superseded  by  update.  July  2015.  Retrieved  12  April  2016.  Available  at 
http://www.wsmr.army.mil/RCCsite/Documents/106-15  Telemetry  Standards/Chapter9.pdf. 
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Chapter  5  covers  data  file  interpretation. 

Chapter  6  covers  IRIG  106  standard  conformance  issues. 

Appendix  A,  Appendix  B.  and  Appendix  C  offer  example  source  code. 

1.3  Document  Conventions 

In  the  sections  that  follow,  example  computer  source  code  and  data  structures  are 
presented.  All  computer  code  is  written  in  ANSI  C.  Occasionally  C-like  pseudo-code  is  used  to 
demonstrate  an  algorithm  more  succinctly  than  strictly  legal  C.  These  instances  will  be  obvious 
from  the  context. 

Different  programming  languages  have  different  default-sized  variables.  Even  different 
compilers  for  a  single  language  like  C  will  have  different  variable  sizes.  Many  variables  and 
structures  need  to  be  represented  with  specific-sized  variables.  In  this  document  and  with  the 
source  code  that  accompanies  it,  this  is  accomplished  by  defining  standard-sized  variable  types. 
The  variable  type  naming  convention  used  is  the  same  convention  used  in  later  versions  of  the 
Gnu  Compiler  Collection  (GCC)  C  run-time  library.  The  variable  type  names  used  are  shown  in 
Table  1-1. 


Table  1-1.  Standard-Sized  Variable  Types 

int8  t 

integer,  signed,  8  bit 

intl6  t 

integer,  signed,  16  bit 

int32  t 

integer,  signed,  32  bit 

int64  t 

integer,  signed,  64  bit 

uint8  t 

integer,  unsigned,  8  bit 

uintl6  t 

integer,  unsigned,  16  bit 

uint32  t 

integer,  unsigned,  32  bit 

uint64  t 

integer,  unsigned,  64  bit 

Hungarian  notation  is  used  for  variable  and  structure  naming  to  help  keep  variable  type 
and  meaning  clear.  The  Hungarian  prefixes  used  in  the  example  code  are  shown  in  Table  1-2. 


Table  1-2.  Hungarian  Notation  Prefixes 

i 

Signed  integer 

u 

Unsigned  integer 

b 

Boolean  flag 

ch 

Character 

by 

Byte 

su 

Structure  variable 

Su 

Structure  name 

a 

Array  of... 

p 

Pointer  to... 
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CHAPTER  2 

Recorder  Setup  and  Configuration 

Chapter  9  of  the  IRIG  106  defines  TMATS,  which  historically  has  been  used  as  a 
shorthand  way  of  documenting  and  describing  recorded  data  to  facilitate  future  data 
interpretation  and  reduction.  In  the  context  of  Chapter  10,  TMATS  is  still  used  to  document 
recorded  data,  but  is  also  used  for  recorder  setup  and  configuration. 

The  TMATS  format  is  designed  to  be  humanly  readable  text,  but  structured  to  be 
machine-parsable.  Each  attribute  appears  in  the  TMATS  file  as  a  unique  code  name  and  data 
item  pair.  The  code  name  appears  first,  delimited  by  a  colon.  The  data  item  follows,  delimited 
by  a  semicolon.  An  attribute  has  the  form  “CODE  :  DATA;  ”.  Lines  may  be  terminated  with  a 
carriage  return  and  line  feed  to  improve  readability,  but  are  not  required.  Attributes  are  limited 
to  2048  bytes.  The  2007  version  of  the  IRIG  106  introduced  an  XML  version  of  TMATS, 
although  vendor  support  for  this  method  has  been  limited  to  this  point. 

The  TMATS  attributes  are  logically  arranged  in  a  hierarchical  tree  structure.  Ligure  9-1 
in  the  Chapter  9  standard  shows  this  attribute  tree  structure.  Unlike  other  markup  languages, 
extensible  Markup  Language  (XML)  for  example,  the  structure  of  the  attribute  tree  is  not 
inherent  in  the  position,  structure,  or  syntax  of  individual  TMATS  lines.  Instead  the  hierarchical 
connections  are  deduced  by  matching  attribute  names  from  different  tree  levels.  Lor  example, 
TMATS  “R”  attributes  are  linked  to  the  corresponding  TMATS  “G”  attribute  by  matching  the 
“R-m\ID”  (e.g.,  R-1\ID  :MyDataSource;)  attribute  with  the  corresponding  “G\DSI-n” 
attribute  (e.g.,  G\DSI-1 :  MyDataSource ; ).  An  example  of  a  portion  of  a  TMATS  attribute 
tree  is  shown  in  Ligure  2-1.  Chapter  9  defines  the  specific  linking  fields  for  the  various  levels  of 
the  TMATS  attribute  tree. 
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(G)  Program  Name  -  A-10_989-ATP.tmt 
|~  (G)  TMATS  Version  -  2 
i- (GXDSI-l)  Data  Source  ID  -  DATASOURCE 
I-  (GVDST-l)  Data  Source  Type  -  OTH 
i- (R-1\ID)  ID  -  DATASOURCE 

0- (R-1\DSI-1)  Data  Source  ID  -  TimelnChanl 
(R-1\DST-1)  Channel  Type  -  TIMIN 
|  j- (R-1VTK1-1)  Track  Humfcer  -  1 
j  L (R-1\CHE-1)  ENABLED 

0  (R-l\DSI-2)  Data  Source  ID  -  VoicelnChanl 
j  j-  (R-l\DST-2)  Channel  Type  -  ANAIN 

j  j-  (R-l\TKl-2)  Track  Numfcer  -  2 

|  L (R-l\CHE-2)  DISABLED 
0--  (R-l\DSI-3)  Data  Source  ID  -  1553InChanl 
j-  (R-l\DST-3)  Channel  Type  -  1553IN 
j  j-  (R-l\TKl-3)  Track  Humfcer  -  11 

j  I-  (R-l\CHE-3)  ENABLED 

|  0  (M-1\BB\DLN)  DLN  -  1553InChanl 

j-  (M-1\BSG1)  PCM 
!-  (M-1UD)  1553InChanl 
0  (R-l\DSI-4)  Data  Source  ID  -  1553InChan2 

0-  (R-l\DSI-5)  Data  Source  ID  -  1553InChan3 

0  (R-1VDSI-6)  Data  Source  ID  -  1553InChan4 

0  (R-l\DSI-7)  Data  Source  ID  -  PCMInChanl 

0  (R-1XDSI-8)  Data  Source  ID  -  PCMInChan2 

0  (R-l\DSI-9)  Data  Source  ID  -  PCMInChan3 

0  (R-1\DSI-10)  Data  Source  ID  -  PCMInChan4 


Figure  2-1.  Example  TMATS  Attribute  Tree 

Attribute  lines  can  be  easily  parsed  using  the  string  tokenizer  function  strtok  ( )  in  the 
C  run  time  library.  An  example  approach  outline  for  TMATS  parsing  is  shown  in  Figure  2-2. 

The  TMATS  attribute  line  is  stored  in  the  null  terminated  character  array  szLine  [  ] .  The  code 
name  string  is  pointed  to  by  szCodeName  and  the  data  item  value  is  pointed  to  by 
szDataltem.  Specific  parsers  are  called  for  specific  attribute  types,  indicated  by  the  first  letter 
of  the  code  name.  After  all  TMATS  attributes  are  read,  they  are  linked  into  a  hierarchical  tree. 

A  more  complete  example  of  TMATS  parsing  is  presented  in  Appendix  C. 
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char  szLine [2048] ; 

char  *  szCodeName; 

char  *  szDataltem; 

//  Split  the  line  into  left  hand  and  right  hand  sides 
szCodeName  =  strtok (szLine, 
szDataltem  =  strtok(NULL, 

//  Determine  and  decode  different  TMATS  types 
switch  (szCodeName [0] ) 

{ 

case  ' G'  :  //  Decode  General  Information 
break; 

case  'B'  :  //  Decode  Bus  Data  Attributes 

break; 

case  ' R'  :  //  Decode  Tape/Storage  Source  Attributes 
break; 

case  'T'  :  //  Decode  Transmission  Attributes 

break; 

case  'M'  :  //  Decode  Multiplexing/Modulation  Attributes 

break; 

case  ' P'  :  //  Decode  PCM  Format  Attributes 
break; 

case  'D'  :  //  Decode  PCM  Measurement  Description 

break; 

case  'S'  :  //  Decode  Packet  Format  Attributes 

break; 

case  'A'  :  //  Decode  PAM  Attributes 

break; 

case  ' C'  :  //  Decode  Data  Conversion  Attributes 
break; 

case  'H'  :  //  Decode  Airborne  Hardware  Attributes 

break; 

case  'V'  :  //  Decode  Vendor  Specific  Attributes 

break; 

default  : 
break; 

}  //  end  decoding  switch 

/ /  Now  link  the  various  records  together  into  a  tree 

vConnectRtoG (...); 

vConnectMtoR (...); 

vConnectBtoM (...); 

Figure  2-2.  TMATS  Attribute  Parser  Example  Code 

There  are  two  basic  types  of  attribute  code  names:  single  entry  and  multiple  entry. 
Single-entry  attributes  are  those  for  which  there  is  only  one  data  item  and  appear  once  in 
TMATS.  For  example: 

G\PN:EW  EFFECTIVENESS; 

Multiple-entry  attributes  may  appear  multiple  times.  They  are  distinguished  by  a 
numeric  identifier  preceded  by  a  hyphen.  For  example: 
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G\DSI-1 : Aircraft; 

G\DSI-2 : Missile; 

G\DSI-3 : Target; 

Some  attributes  can  appear  multiple  times  at  multiple  levels.  For  example,  the  Message 
Data  Sub-Channel  Name  attribute  “R-x\MCNM-n-m”  may  appear  associated  with  multiple 
recorder  groups  (“x”),  multiple  message  data  channels  (“n”),  and  with  multiple  subchannels 
(“m”). 

Chapter  9  identifies  quite  a  few  required  TMATS  attributes.  These  attributes  are 
necessary  to  ensure  correct  recorder  setup  and  subsequent  data  interoperability.  For  correct 
TMATS  parsing  and  interpretation,  an  important  required  attribute  is  “G  \  1 0  6”.  This  attribute 
identifies  the  version  of  IRIG  106  to  use  when  interpreting  the  TMATS  information.  This 
attribute  only  identifies  the  TMATS  version.  The  overall  recorder  version  is  specified  in  the 
TMATS  setup  record  in  the  recorded  data  file  described  in  Subsection  5.5.2. 

Chapter  9  states  that  attributes  may  appear  in  any  order.  Chapter  10,  however,  requires 
some  specific  TMATS  comment  attributes  follow  other  specific  modified  TMATS  attributes  for 
modified  data  files.  This  complicates  TMATS  machine  parsing  considerably.  When  reading  and 
decoding  TMATS,  a  parser  must  maintain  the  most  recent  recorder  data  channel  state  so  that 
when  a  comment  attribute  is  encountered,  it  can  be  associated  with  the  correct  recorder  channel. 
When  writing  TMATS,  the  appropriate  comments  must  follow  the  appropriate  attribute  records. 
See  Chapter  10  for  specific  TMATS  attribute  position  and  order  requirements. 
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CHAPTER  3 
Data  Retrieval 

3.1  Small  Computer  Systems  Interface  (SCSI)  Protocol 

Recorded  data  from  a  Chapter  10  recorder  is  retrieved  by  transferring  it  to  a  host 
computer  over  one  of  several  interfaces  provided  by  the  recorder.  Chapter  10  requires  that  each 
removable  memory  module  (RMM)  provide  an  IEEE  1394b  data  download  port.  Chapter  10 
also  requires  that  each  recorder  provide  either  a  Fibre  Channel  or  IEEE  1394b  data  download 
port,  and  optionally  an  Ethernet  download  port. 

The  protocol  for  data  download  over  the  various  interface  types  is  the  SCSI  block  transfer 
protocol.  Overall  SCSI  operation  is  defined  in  the  SCSI  Architecture  Model  2  (SAM-2)5 
document.  Common  commands  are  defined  in  the  SCSI  Primary  Commands  (SPC-2)6 
document.  Commands  for  block  devices  are  defined  in  the  SCSI  Block  Commands  2  (SBC-2)7 
document. 

The  SCSI  architecture  is  a  client-server  model.  The  client  is  the  user  application  (the 
“initiator”),  requesting  services  (status,  data,  etc.)  from  the  SCSI  server  device  (the  “target”).  An 
application  client  is  independent  of  the  underlying  interconnect  and  SCSI  transport  protocol. 

Each  SCSI  target  is  identified  by  a  target  device  name.  Targets  are  addressed  using  the  target 
device  name.  Different  transports  support  different  methods  for  uniquely  naming  SCSI  targets. 
Each  target  device  also  supports  one  or  more  logical  unit  numbers  (LUNs),  which  are  used  to 
support  different  services  from  a  single  SCSI  target  device.  For  example,  an  RMM  provides  disk 
file  access  using  LUN  0  and  real-time  clock  access  using  LUN  1 . 

The  SCSI  architecture  model  defines  a  Command  Descriptor  Block  (CDB)  structure 
along  with  associated  user  input/output  (I/O)  buffers.  In  order  to  issue  a  command  to  a  SCSI 
device,  a  CDB  must  be  used.  The  SCSI  protocol  defines  a  large  number  of  commands  to  support 
a  wide  range  of  devices.  The  Chapter  10  standard  only  requires  a  small  subset  of  the  complete 
SCSI  command  set  to  be  implemented  to  support  the  RMM  and  remote  data  access  block 
transfer  device.  Acceptable  lengths  for  CDBs  can  be  6,  10,  12,  or  16  bytes.  Chapter  10  currently 
only  requires  6-  and  10-byte  CDBs.  Note  that  multi-byte  CDB  values  such  as  logical  block 
address  (LB  A)  are  big-endian  in  the  CDB  and  require  writing  to  the  CDB  a  byte  at  a  time  from  a 
little-endian  processor  to  write  the  multi-byte  values  in  proper  order. 


5  International  Organization  for  Standardization/International  Electrotechnical  Commission.  Information 
Technology  -  Small  Computer  System  Interface  (SCSI)  Part  412:  Architecture  Model-2  (SAM-2).  ISO/IEC  14776- 
412.  October  2006.  Retrieved  9  August  2016.  Available  for  purchase  at 

http://www.iso.org/iso/iso  catalogue/catalogue  tc/catalogue  detail. htm?csnumber=39517. 

6  International  Organization  for  Standardization/International  Electrotechnical  Commission.  Information 
Technology  -  Small  Computer  System  Interface  (SCSI)  Part  452:  SCSI  Primary  Commands-2  (SPC-2).  ISO/IEC 
14776-452:2005.  August  2005.  Retrieved  9  August  2016.  Available  for  purchase  at 
http://www.iso.org/iso/home/store/catalogue  tc/catalogue  detail. htm?csnumber=3 8775. 

7  International  Organization  for  Standardization/International  Electrotechnical  Commission.  Information 
Technology  -  Small  Computer  System  Interface  (SCSI)  Part  322:  SCSI  Block  Commands-2  (SBC-2).  ISO/IEC 
14776-322:2007.  February  2007.  Retrieved  9  August  2016.  Available  for  purchase  at 
http://www.iso.org/iso/home/store/catalogue  tc/catalogue  detail. htm?csnumber=42101. 


3-1 


IR1G  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


The  SCSI  INQUIRY  command  is  used  to  query  the  SCSI  device  about  its  capabilities. 
The  structure  for  the  INQUIRY  CDB  is  shown  in  Figure  3-1.  The  structure  for  the  Control  field 
is  show  in  Figure  3-2.  The  data  download  interface  is  required  to  support  the  standard 
INQUIRY  response  shown  in  Figure  3-3.  Also  required  are  the  Supported  Vital  Product  page, 
Unit  Serial  Number  page,  and  Device  Identification  page. 


struct  SuCdblnquiry 
{ 


uint8 

t 

uOpCode ; 

// 

Operation  code  =  0x12 

uintO 

t 

bEVPD  : 

1; 

// 

Enable  vital  product  data 

uint8 

t 

bCmdDt  : 

1; 

// 

Command  support  data 

uint8 

t 

Reserved!  : 

6; 

// 

uint8 

t 

uPageOpCode ; 

// 

Page  or  operation  code 

uint8 

t 

ReservedP ; 

// 

uint8 

t 

uAl locLength ; 

// 

Allocation  length 

struct  SuCdbControl  suControl; 

} ; 

Figure  3- 1 .  SCSI  INQUIRY  CDB  Structure 


struct  SuCdbControl 


{ 


uint8 

t 

bLink 

1; 

uint8 

t 

Obsolete 

1; 

uint8 

t 

bNACA 

1; 

uint8 

t 

Reserved 

3; 

uint8 

}; 

t 

uVendor 

2; 

Figure  3-2. 

SCSI  CDB  Control  Field  Structure 
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struct  SuCdblnquiryStdData 
{ 


uint8 

t 

uPer iphType  ; 

uint8 

t 

uPer iphQual  ; 

uint8 

t 

uReservedl 

7; 

uint8 

t 

bRMB 

1; 

uint8 

t 

uVersion; 

uint8 

t 

uFormat 

4; 

uint8 

t 

bHiSup 

1; 

uint8 

t 

bNormACA 

1; 

uint8 

t 

uReserved2 

1; 

uint8 

t 

bAERC 

1; 

uint8 

t 

uAddLength ; 

uint8 

t 

uReserved3 

7; 

uint8 

t 

bSCCS 

1; 

uint8 

t 

bAddrl6 

1; 

uint8 

t 

uReserved4 

O  . 
r 

uint8 

t 

bMChngr 

1; 

uint8 

t 

bMultiP 

1; 

uint8 

t 

bVSl 

1; 

uint8 

t 

bEncServ 

1; 

uint8 

t 

bBQue 

1; 

uint8 

t 

bVS2 

1; 

uint8 

t 

bCmdQue 

1; 

uint8 

t 

uReserved5 

1; 

uint8 

t 

bLinked 

1; 

uint8 

t 

bSync 

1; 

uint8 

t 

bWBusl6 

1; 

uint8 

t 

uReserved6 

1; 

uint8 

t 

bRelAddr 

1; 

uint8 

t 

uVendor ID [ 8 ] ; 

uint8 

t 

uProductID [16 

; 

uint8 

t 

uProductRev [ 4 

; 

}; 

//  Peripheral  device  type 
//  Peripheral  qualifier 

//  Removable  medium 
//  Version 

//  Response  data  format 
//  Hierarchical  support 
//  Support  normal  ACA  bit 

//  Asynchronous  event  reporting  cap 
//  Length  of  additional  parameters 

//  Embedded  storage  array  supported 
//  Not  used 

/ /  Medium  changer 

//  Multi-port  device 

//  Vendor  specific 

//  Enclosure  service 

//  Basic  queing 

//  Vendor  specific 

//  Command  queuing  supported 

//  Linked  commands  supported 
//  Not  used 
/ /  Not  used 

//  Relative  addressing  supported 

// 

// 

// 


Figure  3-3.  SCSI  INQUIRY  Data  Structure 

The  SCSI  READ  CAPACITY  command  is  used  to  query  the  disk  device  about  its  size. 
The  structure  for  the  READ  CAPACITY  CDB  is  shown  in  Figure  3-4.  This  command  returns 
the  number  of  available  logical  blocks  and  the  logical  block  size  in  bytes,  shown  in  Figure  3-5. 
Note  that  returned  values  are  big-endian  and  must  be  byte  swapped  before  they  can  be  used  on  a 
little-endian  processor. 
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struct  SuCdbReadCapacitylO 
{ 


uint8 

t 

uOpCode ; 

// 

Operation  code 

=  0x25 

uint8 

t 

uReservedl  ; 

// 

uint8 

t 

uLBA  3  MSB; 

// 

Logical 

block 

address. 

MSB 

uint8 

t 

uLBA  2; 

// 

Logical 

block 

address 

uint8 

t 

uLBA  1; 

// 

Logical 

block 

address 

uint8 

t 

uLBA  0  LSB; 

// 

Logical 

block 

address, 

LSB 

uint8 

t 

uReserved2; 

// 

uint8 

t 

uReserved3; 

// 

uint8 

t 

bPMI 

:  1; 

// 

Partial 

medium 

i  indicator 

uint8 

t 

uReserved3 

:  7; 

// 

struct  SuCdbControl  suControl; 

)  ; 

Figure  3-4.  SCSI  READ  CAPACITY  CDB  Structure 


struct  SuCdbReadCapacityData 

{ 

uint64_t  uBlocks;  //  Logical  blocks  (big  endian!) 

uint64_t  uBlockSize;  //  Block  size  (big  endian!) 

}; _ 

Figure  3-5 .  SCSI  READ  CAPACITY  Data  Structure 

The  SCSI  READ  command  is  used  to  read  logical  blocks  of  data  from  the  disk  device. 
The  SCSI  protocol  provides  five  different  READ  commands  with  various  capabilities  and  sizes 
of  the  CDB.  The  Chapter  10  standard  only  requires  the  10-byte  variant  of  the  READ  command. 
The  structure  for  the  READ  CDB  is  shown  in  Figure  3-6.  This  command  returns  the  data  from 
the  requested  logical  blocks. 


struct  SuCdbReadlO 


{ 

uint8_t 
uint8_t 
uint8_t 
uint8~t 
uint8_t 
uint8_t 
uint8_t 
uint8  t 
uint8  t 
uint8  t 
uint8_t 
uint8  t 
uint8  t 
uint8_t 
uint8  t 


uOpCode ; 

bReservedl  :  1; 

bFUA_NV  :  1; 

Reserved2  :  1; 

bFUA  :  1; 

bDPO  :  1 ; 

bRdProtect  :  3; 

uLBA  3  MSB; 
uLBA  2; 
uLBAl; 
uLBA_0_LSB; 
uGroupNum  :  5; 

Reserved3  :  3; 

uTransLength_l_MSB; 
uTransLength_0_LSB; 


struct  SuCdbControl  suControl; 


) ; 


//  Operation  code  =  0x28 

// 

//  Force  unit  access  non-volatile 

// 

//  Force  unit  access 

//  Disable  page  out 

//  Read  protect 

//  Logical  block  address,  MSB 

//  Logical  block  address 

//  Logical  block  address 

//  Logical  block  address,  LSB 

//  Group  number 

// 

//  Transfer  length,  MSB 
//  Transfer  length,  LSB 


Figure  3-6.  SCSI  READ(10)  CDB  Structure 
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3.1.1  IEEE  1394 

The  IEEE  13948  standard  defines  the  Serial  Bus  Protocol  (SBP-2)  for  transporting  CDBs 
and  data  over  a  1394  bus  to  a  SCSI  target.  The  basic  unit  of  information  in  SBP-2  is  the 
Operation  Request  Block  (ORB),  which  encapsulates  the  infonnation  in  SCSI  CDBs  and 
input/output  buffers,  as  well  as  additional  information  needed  by  the  1394  bus.  1394  operates  by 
exposing  a  shared  memory  address  space,  negotiated  during  device  initialization.  The  CDBs 
carried  within  SBP  packets  are  written  to  the  SCSI  target  device  shared  memory,  and  associated 
data  is  written  to  and  read  from  shared  memory. 

When  interfacing  to  an  RMM,  LUN  0  is  used  for  disk  access.  The  LUN  1  is  used  for 
interfacing  to  the  RMM  real-time  clock. 

When  interfacing  to  a  recorder,  LUN  0  or  32  is  used  for  disk  access. 

3.1.2  Fibre  Channel 

Fibre  Channel  defines  the  Fibre  Channel  Protocol  (FCP)  for  transporting  CDBs  and  data 
over  a  Fibre  Channel  bus  to  a  SCSI  target.  The  basic  unit  of  information  in  FCP  is  the 
information  unit  (IU).  Communication  with  SCSI  targets  uses  several  types  of  IUs  defined  by 
FCPs.  Fibre  Channel  also  defines  the  Fibre  Channel  Private  Loop  SCSI  Direct  Attach  (FC- 
PLDA)  protocol,  which  further  defines  the  implementation  of  SCSI  over  Fibre  Channel.  Chapter 
10  requires  conformance  to  FC-PLDA. 

3.1.3  Internet  Small  Computer  Systems  Interface 

The  Internet  Engineering  Task  Force  (IETF)  has  published  Request  For  Comment  (RFC) 
32709  defining  the  Internet  Small  Computer  Systems  Interface  (iSCSI)  protocol  for  transporting 
CDBs  over  Transmission  Control  Protocol  (TCP)/Intemet  Protocol  (IP)-based  networks  to  a 
SCSI  target.  Chapter  10  identifies  iSCSI  as  the  standard  protocol  for  recorder  data  access  over 
Ethernet.  The  basic  unit  of  information  in  iSCSI  is  the  protocol  data  unit  (PDU),  which 
encapsulates  the  infonnation  in  SCSI  CDBs  and  input/output  buffers  as  well  as  additional 
information  needed  by  the  underlying  IP  network.  The  PDUs  are  transported  over  a  TCP 
connection,  usually  using  well-known  port  number  860  or  3260.  The  actual  port  number  used  is 
not  specified  in  Chapter  10. 

For  an  iSCSI  initiator  to  establish  an  iSCSI  session  with  an  iSCSI  target,  the  initiator 
needs  the  IP  address,  TCP  port  number,  and  iSCSI  target  name  information.  There  are  several 
methods  that  may  be  used  to  find  targets.  The  iSCSI  protocol  supports  the  following  discovery 
mechanisms. 

•  Static  Configuration:  This  mechanism  assumes  that  the  IP  address,  TCP  port,  and  the 
iSCSI  target  name  information  are  already  available  to  the  initiator.  The  initiators  need 
to  perfonn  no  discovery  in  this  approach.  The  initiator  uses  the  IP  address  and  the  TCP 
port  infonnation  to  establish  a  TCP  connection,  and  it  uses  the  iSCSI  target  name 


8  Institute  of  Electrical  and  Electronics  Engineers.  IEEE  Standard  for  a  High-Performance  Serial  Bus.  IEEE  1394- 
2008.  New  York:  Institute  of  Electrical  and  Electronics  Engineers,  2008. 

9  Internet  Engineering  Task  Force.  “Multi-Protocol  Label  Switching  (MPLS)  Support  of  Differentiated  Services.” 
RFC  3270.  May  2002.  Updated  by  RFC  5462.  Retrieved  22  June  2016.  Available  at 

http://data  tracker,  ietf.  org/doc/rfc3 2 70/. 
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information  to  establish  an  iSCSI  session.  This  discovery  option  is  convenient  for  small 
iSCSI  setups. 

•  SendTargets:  This  mechanism  assumes  that  the  target's  IP  address  and  TCP  port 
information  are  already  available  to  the  initiator.  The  initiator  then  uses  this  information 
to  establish  a  discovery  session  to  the  network  entity.  The  initiator  then  subsequently 
issues  the  SendTargets  text  command  to  query  information  about  the  iSCSI  targets 
available  at  the  particular  network  entity  (IP  address). 

•  Zero-Configuration:  This  mechanism  assumes  that  the  initiator  does  not  have  any 
information  about  the  target.  In  this  option,  the  initiator  can  either  multicast  discovery 
messages  directly  to  the  targets  or  it  can  send  discovery  messages  to  storage  name 
servers.  Currently,  there  are  many  general-purpose  discovery  frameworks  available. 
Service  Location  Protocol  (RFC  2608 10)  and  Internet  Storage  Name  Service  (RFC4171 n) 
are  two  popular  discovery  protocols. 

Target  discovery  is  not  specified  in  Chapter  10. 

When  interfacing  to  a  recorder,  LUN  0  or  32  is  used  for  disk  access.  LUN  1  or  33  is  used 
for  command  and  control. 

3.2  Software  Interface 

Ah  recorder  data  download  interfaces  appear  as  SCSI  block  I/O  devices  and  respond  to 
the  subset  of  SCSI  commands  set  forth  in  Chapter  10,  but  different  operating  systems  provide 
vastly  different  types  of  application  programming  interfaces  (APIs)  for  communicating  with 
recorders  and  RMMs  over  the  various  data  download  interfaces  specified  in  Chapter  10. 

The  Microsoft  Windows  device  driver  environment  helps  remove  a  lot  of  complexity 
from  communicating  over  the  various  data  interfaces.  Windows  Plug  and  Play  drivers  are  able  to 
discover  various  types  of  SCSI  devices  connected  to  them,  initialize  and  configure  them,  and 
then  offer  a  single  programming  interface  for  user  application  programs. 

The  interface  used  by  Windows  applications  to  send  SCSI  commands  to  a  SCSI  device  is 
called  SCSI  Pass  Through  (SPT).  Windows  applications  can  use  SPT  to  communicate  directly 
with  SCSI  devices  using  the  Win32  API  Device IoControl  ( )  call  and  the  appropriate  I/O 
control  code  (IOCTL). 

Before  any  IOCTLs  can  be  sent  to  a  SCSI  device,  a  handle  for  the  device  must  be 
obtained.  The  Win32  API  CreateFile  ( )  is  used  to  obtain  this  handle  and  to  define  the 
sharing  mode  and  the  access  mode.  The  access  mode  must  be  specified  as  (GENERICREAD  | 
GENERIC  WRITE).  The  key  to  obtaining  a  valid  handle  is  to  supply  the  proper  filename  for 
the  device  that  is  to  be  opened. 

For  Chapter  10  SCSI  devices,  the  SCSI  class  driver  defines  an  appropriate  name.  If  the 
device  is  unclaimed  by  a  SCSI  class  driver  (the  usual  case),  then  a  handle  to  the  SCSI  port  driver 
is  required.  The  filename  in  this  case  is  “\\  .  \ScsiN :  ”,  where  N  =  0,  1,2,  etc.  The  number  N 
corresponds  to  the  SCSI  host  adapter  card  number  that  controls  the  desired  SCSI  device.  When 


10  Internet  Engineering  Task  Force.  “Service  Location  Protocol,  Version  2.”  RFC  2608.  June  1999.  Updated  by 
RFC  3224.  Retrieved  22  June  2016.  Available  at  http://datatracker.ietf.org/doc/rfc2608/. 

11  Internet  Engineering  Task  Force.  “Internet  Storage  Name  Service  (iSNS).”  RFC  4171.  September  2005.  Maybe 
superseded  by  update.  Retrieved  22  June  2016.  Available  at  http://www.rfc-editor.org/info/rfc4 171. 
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the  SCSI  port  name  is  used,  the  Win32  application  must  set  the  proper  Pathld,  Target  Id, 
and  LUN  in  the  SPT  structure. 

Once  a  valid  handle  to  a  SCSI  device  is  obtained,  then  appropriate  I/O  buffers  for  the 
requested  IOCTL  must  be  allocated  and,  in  some  cases,  filled  in  correctly. 

There  are  several  IOCTLs  that  the  SCSI  port  driver  supports,  including  the  following. 

•  IOCTL_SCSI_GET_INQUIRY_DATA 

•  IOCTL_SCS I_GET_CAP ABILITIES 

•  IOCTL_SCSI_PASS_THROUGH 

•  IOCTL_SCSI_PASS_THROUGH_DIRECT 

IOCTL_SCSI_GET_INQUIRY_DATA  returns  a  SCSI_ADAPTER_BUS_INFO 
structure  for  all  devices  that  are  on  the  SCSI  bus.  The  structure  member,  BusData,  is  a 
structure  of  type  SCSI_BUS_DATA.  It  contains  an  offset  to  the  SCSI  Inquiry  data,  which  is  also 
stored  as  a  structure,  SCSI_INQUIRY_DATA. 

Within  the  SCSI_INQUIRY_DATA  is  a  structure  member  named  DeviceClaimed, 
which  indicates  whether  or  not  a  class  driver  has  claimed  this  particular  SCSI  device.  If  a  device 
is  claimed,  all  SPT  requests  must  be  sent  first  through  the  class  driver,  which  will  typically  pass 
the  request  unmodified  to  the  SCSI  port  driver.  If  the  device  is  unclaimed,  the  SPT  requests  are 
sent  directly  to  the  SCSI  port  driver. 

For  IOCTL_SCSI_GET_INQUIRY_DATA,  data  is  only  read  from  the  device  and  not 
sent.  Set  lpInBuffer  to  NULL  and  nlnBuf  ferSize  to  zero.  The  output  buffer  might  be 
quite  large,  as  each  SCSI  device  on  the  bus  will  provide  data  that  will  fill  three  structures  for 
each  device:  SCSI_ADAPTER_BUS_INFO,  SCSI_BUS_DATA,  and 

SCSI_INQUIRY_DATA.  Allocate  a  buffer  that  will  hold  the  information  for  all  the  devices  on 
that  particular  SCSI  adapter.  Set  lpOutBuf  f  er  to  point  to  this  allocated  buffer  and 
nOutBuf  ferSize  to  the  size  of  the  allocated  buffer. 

IOCTL_SCS I_GET_CAP ABILITIES  returns  an  IO_SCSI_CAPABILITIES 

structure.  This  structure  contains  valuable  information  about  the  capabilities  of  the  SCSI 
adapter.  Two  items  of  note  are  the  MaximumTransf  erLength,  which  is  a  byte  value 
indicating  the  largest  data  block  that  can  be  transferred  in  a  single  SCSI  Request  Block,  and  the 
MaximumPhysicalPages,  which  is  the  maximum  number  of  physical  pages  that  a  data 
buffer  can  span. 

The  two  IOCTLs IOCTL_SCSI_PASS_THROUGH  and 
IOCTL_SCSI_PASS_THROUGH_DIRECT  allow  SCSI  CDBs  to  be  sent  from  a  Win32 
application  to  a  SCSI  device.  Depending  on  which  IOCTL  is  sent,  a  corresponding  pass  through 
structure  is  filled  out  by  the  Win32  application.  IOCTL_SCSI_PASS_THROUGH  uses  the 
structure  SCSI_PASS_THROUGH.  IOCTL_SCSI_PASS_THROUGH_DIRECT  uses  the 
structure  SCSI_PASS_THROUGH_DIRECT.  The  SCS I_PASS_THROUGH  structure  is  shown 
in  Figure  3-7. 
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struct  SCSI  PASS  THROUGH 

{ 

USHORT  Length; 

UCHAR 

ScsiStatus; 

UCHAR 

Pathld; 

UCHAR 

Targetld; 

UCHAR 

Lun; 

UCHAR 

CdbLength; 

UCHAR 

Senselnf oLength; 

UCHAR 

Dataln; 

ULONG 

DataTransf erLength; 

ULONG 

TimeOutValue ; 

ULONG 

DataBuf ferOff set ; 

ULONG 

Sense InfoOf f set; 

UCHAR 

}; 

C|db  [16]  ; 

Figure  3-7.  SCSIPASSTHROUGH  Structure 

The  structures  SCSI_PASS_THROUGH  and  SCSI_PASS_THROUGH_DIRECT  are 
virtually  identical.  The  only  difference  is  that  the  data  buffer  for  the  SCSI_PASS_THROUGH 
structure  must  be  contiguous  with  the  structure.  This  structure  member  is  called 
DataBuf  f  erOf  f  set  and  is  of  type  ULONG.  The  data  buffer  for  the 

SCSI_PASS_THROUGH_DIRECT  structure  does  not  have  to  be  contiguous  with  the  structure. 
This  structure  member  is  called  DataBuf  fer  and  is  of  type  PVOID. 

For  the  two  SPT  IOCTLs,  IOCTL_SCSI_PASS_THROUGH  and 
IOCTL_SCSI_PASS_THROUGH_DIRECT,  both  lpInBuffer  and  lpOutBuffer  can  vary 
in  size  depending  on  the  Request  Sense  buffer  size  and  the  data  buffer  size.  In  all  cases, 
nlnBuf  ferSize  and  nOutBuf  ferSize  must  be  at  least  the  size  of  the 
SCSI_PASS_THROUGH  (or  SCSI_PASS_THROUGH_DIRECT)  structure.  Once  the 
appropriate  FO  buffers  have  been  allocated,  then  the  appropriate  structure  must  be  initialized. 

The  Length  is  the  size  of  the  SCSI_PASS_THROUGH  structure.  The  ScsiStatus 

should  be  initialized  to  0.  The  SCSI  status  of  the  requested  SCSI  operation  is  returned  in  this 
structure  member.  The  Pathld  is  the  bus  number  for  the  SCSI  host  adapter  that  controls  the 
SCSI  device  in  question.  Typically,  this  value  will  be  0,  but  there  are  SCSI  host  adapters  that 
have  more  than  one  SCSI  bus  on  the  adapter.  The  Target  Id  and  Lun  are  the  SCSI  ID  number 
and  LUN  for  the  device. 

The  CdbLength  is  the  length  of  the  CDB.  Typical  values  are  6,  10,  and  12  up  to  the 
maximum  of  16.  The  Senselnf  oLength  is  the  length  of  the  Senselnfo  buffer.  Dataln 
has  three  possible  values;  SCSI_IOCTL_DATA_OUT,  SCSI_IOCTL_DATA_IN,  and 
SCSI_IOCTL_DATA_UNSPECIFIED.  The  DataTransf  erLength  is  the  byte  size  of  the 
data  buffer.  The  TimeOutValue  is  the  length  of  time,  in  seconds,  until  a  time-out  error  should 
occur.  This  can  range  from  0  to  a  maximum  of  30  minutes  (1800  seconds). 

The  DataBuf  ferOff  set  is  the  offset  of  the  data  buffer  from  the  beginning  of  the  pass 
through  structure.  For  the  SCSI_PASS_THROUGH_DIRECT  structure,  this  value  is  not  an 
offset,  but  rather  is  a  pointer  to  a  data  buffer.  The  Senselnf  oOffset  is  similarly  an  offset  to 
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the  Senselnfo  buffer  from  the  beginning  of  the  pass  through  structure.  Finally,  the  16 
remaining  bytes  are  for  the  CDB  data.  The  fonnat  of  this  data  must  conform  to  the  SCSI-2 
standard. 

3.3  STANAG  4575  Directory 

Chapter  10  recorders  make  their  data  available  for  downloading  over  one  of  their 
supported  download  ports.  To  the  application  program,  the  data  download  port  appears  as  a 
block  FO  disk  device  at  SCSI  LUN  0.  The  directory  structure  on  the  disk  is  a  modified  version 
of  the  STANAG  4575  file  structure  definition.  The  STANAG  file  system  has  been  developed  to 
enable  the  downloading  of  very  large  sequential  files  into  support  workstations.  It  supports  only 
logically  contiguous  files  in  a  single  directory.  The  data  can  be  physically  organized  any  way 
appropriate  to  the  media,  including  multiple  directories,  as  long  as  the  interface  to  the  NADSI 
sees  a  single  directory  of  files  in  contiguous  logical  addresses. 

Disk  blocks  are  accessed  by  LBA.  It  is  common  in  many  operating  systems  and  disk 
structures  for  block  0  to  be  a  master  boot  record  (MBR),  which  typically  contains  operating 
system  boot  code  and/or  information  for  dividing  a  disk  device  into  multiple  partitions.  Chapter 
10  does  not  support  MBRs  or  partitions.  Block  0  is  considered  reserved,  and  its  contents  are 
undefined  and  unused. 

The  beginning  of  the  STANAG  directory  is  always  read  from  LBA  1.  The  complete  disk 
directory  may  span  multiple  disk  blocks.  Directory  blocks  are  organized  as  a  double  linked  list 
of  blocks.  Other  than  the  first  directory  block,  subsequent  directory  blocks  can  be  any  arbitrary 
block  number. 

A  STANAG  4575  directory  block  has  the  structure  shown  in  Figure  3-8.  Keep  in  mind 
that  STANAG  4575  data  is  big-endian  and  so  multi-byte  values  will  need  to  be  byte-swapped 
before  they  can  be  used  on  a  little-endian  processor  such  as  an  Intel  x86  found  in  desktop 
computers.  The  various  fields  in  the  directory  block  are  covered  in  detail  in  the  Chapter  10 
standard.  The  asuFileEntry  [  ]  array  holds  information  about  individual  files.  Its  structure 
is  shown  in  Figure  3-9.  The  size  of  the  asuFileEntry  [  ]  array  will  vary  depending  on  the 
disk  block  size.  For  a  size  of  5 12  bytes  per  disk  block,  the  asuFileEntry  [  ]  array  will  have 
four  elements. 


struct  SuStanag4575DirBlock 
{ 


uint64  t 

uMagicNumber; 

//  "FORTY two" 

uint8  t 

uRevNumber ; 

//  IRIG  106  Revision  number 

uint8  t 

u Shut down ; 

//  Dirty  shutdown 

uintl6  t 

uNumEntries; 

//  Number  of  file  entries 

uint32  t 

uBlockSize; 

//  Bytes  per  block 

uint8  t 

achVolName [32] ; 

//  Volume  Name 

uint8  t 

uFwdLink; 

//  Forward  link  block 

uint8  t 

uRevLink; 

//  Reverse  link  block 

struct  SuStanag4575FileBlock  asuFileEntry [4] ; 

}  ; 

Figure  3-8.  STANAG  4575  Directory  Block  Structure 
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struct  SuSt.anaq4 

575Fi 1 eRl  ock 

t 

uint8  t 

achFileName f 561 ; 

// 

File 

name 

uinL64  t 

uFileStart; 

// 

File 

start  block  addr 

uint64  t 

uFi 1 eRl kCnt; 

// 

File 

bl ock  count 

uint64  t 

uFilcSizc; 

// 

File 

size  in  bytes 

uinL8  L 

uCreateDale I  8  I ; 

// 

File 

create  date 

uint8  t 

uCreateTime [8] ; 

// 

File 

create  time 

uintO  t 

uTimcTypc; 

// 

Date 

and  time  type 

Uint8  t 

achReserved [7 ] ; 

// 

uintO  t 

}; 

uCloscTime | 8 ] ; 

// 

File 

close  time 

Figure  3-9.  STANAG  4575  File  Entry  Structure 


A  complete  disk  file  directory  is  read  starting  at  LBA  1 .  The  first  directory  block  is  read 
and  all  file  entries  in  that  block  are  read  and  decoded.  Then  the  next  directory  block,  LBA  equal 
to  the  value  in  uFwdLink,  is  read  and  decoded.  Directory  reading  is  finished  when  the 
uFwdLink  is  equal  to  the  current  LBA.  This  algorithm  is  shown  in  Figure  3-10. 
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Figure  3-10.  STANAG  4575  Directory  Reading  and  Decoding  Algorithm 
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CHAPTER  4 
Recorder  Control 

Recorders  are  controlled  over  a  full  duplex  communications  channel.  Typically  this 
channel  is  an  RS-232  or  RS-422  serial  communications  port.  Chapter  10  also  allows  control 
over  a  recorder  network  channel. 

The  recorder  command  and  control  mnemonics  (CCM)  language  is  defined  in  Chapter  6, 
with  further  requirements  in  Chapter  10.  Interaction  with  a  recorder  is  in  a  command/control 
fashion.  That  is,  an  external  controller  issues  commands  to  a  recorder  over  the  command  and 
control  channel,  and  the  recorder  issues  a  single  status  response  message. 

Some  commands,  such  as  .BIT,  can  take  a  significant  amount  of  time  to  complete.  The 
proper  method  to  determine  when  these  commands  complete  is  to  issue  multiple  .  STATUS 
commands,  checking  the  status  complete  field  until  it  indicates  the  command  has  completed 
processing. 

4.1  Serial  Control 

Commands  written  to  a  recorder  should  be  terminated  with  carriage  return  and  line  feed 
characters.  Responses  from  the  recorder  also  terminate  with  carriage  return  and  line  feed.  In 
general,  it’s  considered  good  defensive  programming  practice  to  recognize  either  character  alone 
or  both  together  as  a  valid  line  terminator. 

Neither  Chapter  6  nor  Chapter  10  address  serial  flow  control.  Most  commands  generate 
very  little  text  and  buffer  overflow  shouldn’t  be  a  problem.  The  .  TMATS  command,  however, 
can  result  in  a  considerable  amount  of  text  to  be  transferred.  Hardware  flow  control  requires 
additional  signal  lines  that  may  not  be  available  on  a  recorder  command  and  control  interface.  It 
would  be  prudent  to  be  prepared  to  support  XON  and  XOFF  flow  control  in  software. 

4.2  Network  Control 

Chapter  10  provides  a  mechanism  for  remote  command  and  control  over  a  network  port 
using  the  SCSI  protocol.  Chapter  10  defines  separate  logical  units  for  command  and  control. 

The  SCSI  SEND  command  (command  code  =  OxOA)  along  with  a  buffer  containing  a  valid 
Chapter  6  command  is  used  to  send  commands  remotely.  The  SCSI  RECEIVE  command 
(command  code  =  0x08)  is  used  to  receive  the  command  response.  These  SCSI  commands  are 
described  in  the  SCSI  Primary  Commands  document. 
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CHAPTER  5 
Data  File  Interpretation 
5.1  Overall  Data  File  Organization 

Chapter  10  data  files  are  organized  as  a  sequential  series  of  data  packets.  Data  packets 
can  only  contain  one  type  of  data  (i.e.,  1553,  PCM,  etc.).  Data  packets  frequently  contain 
multiple  individual  data  messages. 

The  Chapter  10  standard  requires  that  the  first  data  packet  in  a  data  file  be  an  IRIG  106 
Chapter  9  fonnat  TMATS  packet,  which  is  used  to  configure  the  recorder  and  to  describe  the 
data  begin  recorded.  The  TMATS  information  is  stored  in  a  Computer-Generated  Data,  Format 
1  (Data  Type  =  0x01)  data  packet  and  is  discussed  in  Subsection  5.5.2.  An  important  field  in  the 
packet  header  for  the  TMATS  packet  is  the  ‘TRIG  106  Chapter  10  Version”  field.  The  value  of 
this  field  determines  the  specific  version  of  the  Chapter  10  standard  to  use  when  interpreting  the 
rest  of  the  data  file;  however,  this  field  is  only  defined  for  the  106-07  and  later  versions  of  the 
IRIG  106  standard. 

It  is  required  that  a  time  data  packet  be  the  first  dynamic  data  packet.  Dynamic  data 
packets  are  not  defined  in  the  Chapter  10  standard  but  it  is  generally  understood  to  mean  any 
data  packet  other  than  Computer-Generated  Data,  Format  1  (setup  record).  The  purpose  of  this 
requirement  is  to  allow  the  association  of  clock  time  with  the  relative  time  counter  (RTC)  before 
encountering  the  first  data  packet  in  the  data  file.  Programmers  are  cautioned,  though,  to  verify  a 
valid  time  packet  has  been  received  before  attempting  to  interpret  the  RTC. 

A  root  index  packet  will  be  the  last  data  packet  in  the  data  file  if  file  indexing  is  used. 

The  presence  of  data  file  indexing  is  indicated  in  the  TMATS  setup  record. 

The  size  of  all  data  packets  is  an  integer  multiple  of  4  bytes  (32  bits).  Padding  bytes  are 
added,  if  necessary,  to  the  end  of  a  data  packet,  just  before  the  checksum,  to  provide  this  4-byte 
alignment.  Regardless,  when  defining  data  structures  representing  Chapter  10  data  packets  and 
messages,  these  structures  should  be  forced  to  be  byte-aligned  by  using  the  appropriate  compiler 
directive. 

Some  data  packet  elements  are  two  or  more  bytes  in  length.  For  example,  the  first  data 
element  of  data  packet  is  a  two-byte  sync  pattern.  Multiple-byte  data  elements  are  stored  in 
little-endian  format.  That  is,  the  least  significant  portion  of  the  data  is  stored  at  the  lowest  byte 
offset. 

Data  packets  are  written  to  disk  roughly  in  the  time  order  that  they  are  received,  but  data 
packets  and  data  messages  can  occur  in  the  data  file  out  of  time  order.  This  can  occur  because 
data  recorders  receive  data  simultaneously  on  multiple  channels,  each  channel  buffering  data  for 
a  period  of  time  and  then  writing  it  to  disk.  Because  of  this,  individual  data  messages  will  in 
general  be  somewhat  out  of  time  order  because  of  grouping  by  channel.  Consider  the  case  of 
two  1553  channels  recording  the  same  bus  at  the  same  time  in  an  identical  fashion.  Each  channel 
receives,  buffers,  and  writes  data  to  disk.  The  first  channel  will  write  its  buffered  data  to  disk 
followed  by  the  second  channel.  The  data  from  the  second  channel  will  be  from  the  same  time 
period  as  the  data  from  the  first  channel  and  will  have  identical  time  stamps  but  will  be  recorded 
after  the  first  channel  in  the  data  file. 
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Starting  with  the  IRIG  106-05  standard,  recorders  are  only  allowed  to  buffer  data  for  a 
maximum  of  100  milliseconds  and  data  packets  must  be  written  to  disk  within  one  second.  This 
ensures  that  data  packets  can  only  be  out  of  time  order  by  a  maximum  of  one  second.  Be 
warned,  though,  that  the  maximum  amount  of  time  data  packets  can  be  out  of  order  for  data  files 
produced  before  IRIG  106-05  is  unbounded  and  it  is  not  unusual  to  encounter  data  files  with  data 
packets  five  or  more  seconds  out  of  time  order. 

Example  source  code  that  demonstrates  basic  parsing  of  Chapter  10  data  files  can  be 
found  in  Appendix  A.  An  example  program  that  demonstrates  reading  and  interpreting  a 
Chapter  10  file  can  be  found  in  Appendix  B. 

5.2  Overall  Data  Packet  Organization 

Overall  data  packet  organization  is  shown  in  Figure  5-1.  Data  packets  contain  a  standard 
header,  a  data  payload  containing  one  or  multiple  data  messages,  and  a  standard  trailer.  The 
standard  header  is  composed  of  a  required  header,  optionally  followed  by  a  secondary  header. 
The  data  payload  generally  consists  of  a  channel-specific  data  word  (CSDW)  record  followed  by 
one  or  more  data  messages. 


PACKET  SYNC  PATTERN 

Packet  Header 

CHANNEE  ID 

PACKET  LENGTH 

DATA  LENGTH 

DATA  VERSION 

SEQUENCE  NUMBER 

PACKET  FLAGS 

DATA  TYPE 

RELATIVE  TIME  COUNTER 

HEADER  CHECKSUM 

TIME 

Packet 

Secondary  Header 
(Optional) 

RESERVED 

SECONDARY  HEADER  CHECKSUM 

CHANNEL  SPECIFIC  DATA  WORD 

Packet  Body 

INTRA-PACKET  TIME  STAMP  1 

INTRA-PACKET  DATA  HEADER  1 

DATA  1 

INTRA-PACKET  TIME  STAMP  n 

INTRA-PACKET  DATA  HEADER  n 

DATAn 

DATA  CHECKSUM 

Packet  Trailer 

Figure  5-1 .  Data  Packet  Organization 


Data  packets  must  contain  data.  They  are  not  allowed  to  only  contain  filler,  although 
filler  can  be  inserted  into  a  data  packet  in  the  packet  trailer  before  the  checksum.  This  filler  is 
used  to  ensure  data  packet  alignment  on  a  four-byte  boundary.  Filler  is  also  sometimes  used  to 
keep  packets  from  a  particular  channel  the  same  length.  The  standard  does  not  expressly  prohibit 
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filler  after  the  packet  trailer  but  before  the  next  data  packet  header,  but  inserting  filler  after  the 
last  trailer  is  considered  bad  practice.  Still,  when  reading  data  packets,  set  read  buffer  sizes 
based  on  the  value  of  the  overall  packet  length  found  in  the  header.  Do  not  make  assumptions 
about  packet  length  based  on  the  data  length  or  from  information  in  the  data  payload. 

When  reading  linearly  through  a  Chapter  10  data  file,  maintaining  synchronization  with 
data  packet  boundaries  is  accomplished  by  using  the  packet  length  field  in  the  header  to  read  the 
appropriate  amount  of  data  or  to  reposition  the  read  pointer  to  the  beginning  of  the  next  header. 

In  this  case  it  is  sufficient  to  check  the  value  of  the  Sync  field  at  the  beginning  of  the  header  to 
ensure  the  read  pointer  was  positioned  to  the  beginning  of  a  data  packet. 

If  there  is  an  error  in  the  data  file  or  if  the  read  pointer  is  repositioned  to  some  place  other 
than  the  beginning  of  a  data  packet  (for  example  to  jump  to  the  middle  of  a  recorded  data  file), 
then  the  beginning  of  a  valid  data  packet  must  be  found.  Unfortunately  the  Chapter  10  standard 
does  not  provide  a  way  to  definitively  determine  the  beginning  of  a  data  packet  in  these 
instances.  Instead  some  heuristics  must  be  applied. 

•  Read  the  data  file  until  the  packet  sync  pattern  (0xEB25)  is  found.  (Normally  the  first 
character  of  the  packet  sync  pattern  is  found  at  a  file  offset  that  is  an  integer  multiple  of 
four.  If  the  data  file  is  corrupted  then  the  sync  pattern  may  not  fall  on  the  normal  four- 
byte  boundary.  For  the  best  results  scan  the  file  a  byte  at  a  time,  ignoring  the  normal 
four-byte  alignment.) 

•  When  the  Sync  pattern  is  found  then  calculate  and  test  the  header  checksum. 

•  If  a  secondary  header  exists,  calculate  and  test  the  secondary  header  checksum. 

•  Calculate  and  test  the  data  checksum. 

When  the  packet  sync  pattern  is  found  and  all  available  checksums  have  been  verified, 
then  there  is  a  high  probability  that  the  beginning  of  the  next  valid  data  packet  has  been  found. 

5.3  Required  header 

The  packet  header  contains  information  about  the  data  payload  such  as  time,  packet 
length,  data  type,  data  version,  and  other  information.  The  layout  of  a  Chapter  10  packet  header 
is  shown  in  Figure  5-2. 


struct  SuI106Chl0Header 
{ 


uintl6  t 

uSync; 

// 

Packet  Sync  Pattern 

uintl6  t 

uChID; 

// 

Channel  ID 

uint32  t 

ulPacketLen; 

// 

Total  packet  length 

uint32  t 

ulDataLen; 

// 

Data  length 

uint8  t 

ubyDataVer ; 

// 

Data  Version 

uint8  t 

ubySeqNum; 

// 

Sequence  Number 

uint8  t 

ubyPacketFlags  ; 

// 

Packet  Flags 

uint8  t 

ubyDataType ; 

// 

Data  type 

uint8  t 

aubyRelTime [6] ; 

// 

Reference  time 

uintl6  t 

}; 

uChecksum; 

// 

Header  Checksum 

Figure  5-2.  Packet  Header  Structure 
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The  Channel  ID  field  uniquely  identifies  the  source  of  the  data.  The  value  of  the  Channel 
ID  field  corresponds  to  the  Track  Number  value  of  the  TMATS  “R”  record.  This  field  was 
extended  to  five  characters  in  the  2009  release  of  IRIG  106. 

Typically  only  one  packet  data  type  is  associated  with  a  particular  Channel  ID,  but  this  is 
not  a  requirement  of  the  Chapter  10  standard.  An  exception  to  this  is  Channel  ID  =  0,  the 
Channel  ID  used  for  internal,  computer-generated  format  data  packets.  It  is  typical  for  Channel 
ID  0  to  contain  Computer-Generated  Data,  Format  0  setup  records  (0x01),  Computer-Generated 
Data,  Format  1  recording  events  records  (0x02),  and  Computer-Generated  Data,  Format  3 
recording  index  records  (0x03).  With  the  2013  release  of  IRIG  106  Channel  0  has  been  restricted 
to  setup  records  only. 

The  data  payload  format  is  interpreted  based  on  the  value  of  the  Data  Type  field  and  the 
Data  Version  field  (sometimes  incorrectly  called  Header  Version)  in  the  packet  header.  Each 
packet  data  payload  can  only  contain  one  type  (e.g.,  1553,  PCM,  etc.)  of  data.  A  Chapter  10 
standard  release  will  only  contain  data  format  and  layout  information  for  the  latest  Data  Version. 
The  specific  Data  Version  defined  in  a  particular  Chapter  10  release  can  be  found  in  the  “Data 
Type  Names  and  Descriptions”  table.  Be  warned  that  future  Chapter  10  releases  may  update  or 
change  data  fonnat  or  layout,  indicated  by  a  different  Data  Version  value  in  the  header,  but  the 
Chapter  10  release  will  not  have  information  about  the  previous  Data  Versions.  That 
information  can  only  be  found  in  the  previous  Chapter  10  releases. 

When  processing  a  data  file,  it  is  common  to  only  read  the  data  packet  header,  determine 
if  the  data  portion  is  to  be  read  (based  on  packet  type  or  other  information  gleaned  from  the 
header),  and  if  not  to  be  read  skip  ahead  to  the  next  header.  Skipping  the  data  portion  and 
jumping  ahead  to  the  next  header  is  accomplished  by  using  the  packet  length  in  the  packet 
header.  Below  is  the  algorithm  for  determining  how  many  bytes  to  jump  ahead  in  the  file  byte 
stream  to  reposition  the  read  pointer  to  the  beginning  of  the  next  header. 

•  Read  the  current  primary  header. 

•  Determine  relative  file  offset  to  the  next  header. 

Offset  =  Packet  Length  -  Primary  Header  Length  (24) 

•  Move  read  pointer. 

5.4  Optional  secondary  header 

The  optional  secondary  header  is  used  to  provide  an  absolute  time  (i.e.,  clock  time)  stamp 
for  data  packets.  The  secondary  header  time  format  can  be  interpreted  several  ways.  The 
specific  interpretation  is  determined  by  the  value  of  header  flag  bits  2  and  3.  The  structure  in 
Figure  5-3  is  used  when  secondary  header  time  is  to  be  interpreted  as  a  Chapter  4  format  value 
(flag  bits  3-2  =  0).  The  structure  in  Figure  5-4  is  used  when  secondary  header  time  is  to  be 
interpreted  as  an  IEEE-1588  format  value  (flag  bits  3-2  =  1).  The  structure  in  Figure  5-5  is  used 
when  secondary  header  time  is  to  be  interpreted  as  an  ERTC  format  value  (flag  bits  3-2  =  2). 
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struct  SuTl 06Chl0SecHeader  Ch4Time 

l 

uintl6  t 

uUnused; 

// 

uint!6  t 

uHighBinTime; 

//  High  order  time 

uintl6  t 

uLowBinTime; 

//  Low  order  time 

uintl6  t 

uUSecs; 

//  Microsecond  time 

uintl6  t 

uReserved; 

// 

uint!6  t 
); 

uSecChecksum; 

//  Secondary  Header  Checksum 

Figure  5-3.  Optional  Secondary  Header  Structure  with  IRIG  106  Ch  4  Time 

Representation 


struct  SuI106Chl0SecHeader  1588Time 


{ 

uint32_t 
uint32_t 
uintl6_t 
uintl6_t 
}  ; 


uNanoSeconds ; 
uSeconds; 
uReserved; 
uSecChecksum; 


//  Nano-seconds 
//  Seconds 
// 

//  Secondary  Header  Checksum 


Figure  5-4.  Optional  Secondary  Header  Structure  with  IEEE- 1588  Time 

Representation 


struct  SuI106Chl0SecHeader  ERTCTime 


{ 

uint32_t 

uint32_t 

uintl6_t 

uintl6_t 

}; 


uLSLW; 

uMSLW; 

uReserved; 

uSecChecksum; 


//  Least  significant  long  word 
//  Most  significant  long  word 
// 

//  Secondary  Header  Checksum 


Figure  5-5.  Optional  Secondary  Header  Structure  with  ERTC  Time 

Representantion 


5.5  Data  payload 

After  the  standard  header  and  optional  secondary  header,  each  data  packet  begins  with  a 
CSDW.  This  data  word  provides  infonnation  necessary  to  decode  the  data  messages  that  follow. 
For  example,  it  is  common  for  the  CSDW  to  contain  a  value  for  the  number  of  messages  that 
follow  and  to  have  flags  that  indicate  what  kind  of  intra-packet  headers  (IPHs)  are  used  between 
messages. 

Reading  and  decoding  a  data  packet  is  accomplished  by  first  reading  the  CSDW.  Then 
read  individual  data  messages  that  follow  in  the  data  packet,  taking  into  account  the  appropriate 
IPHs  and  data  formats.  Move  on  to  the  next  header  and  data  packet  when  there  are  no  more  data 
messages  to  read. 

When  IPHs  are  present,  they  typically  contain  one  or  sometimes  more  than  one  time 
stamp  as  well  as  other  information  about  the  data  message  that  follows.  Commonly  used 
structures  for  intra-packet  time  data  are  shown  in  Figure  5-6,  Figure  5-7,  Figure  5-8,  and  Figure 
5-9.  These  four  time  structures  will  be  referenced  in  most  of  the  data  format  descriptions  that 
follow. 
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struct  SuInLrPackeLTimc_RTC 
{ 

uint8  t  aubyRelTime [6] ;  //  48-bit  RTC 

uintl6_t  uUnused;  // 

}; _ 

Figure  5-6.  Intra-Packet  Time  Stamp,  48-bit  RTC 


struct  SuIntrPacketTime  Ch4Time 

{ 

uint!6  t  uUnused; 

// 

uintl6  t 

uHighBinTime; 

// 

High  order  time 

uintl6  t 

uLowBinTime; 

// 

Low  order  time 

uintl6  t 
}; 

uUSecs; 

// 

Microsecond  time 

Figure  5-7.  Intra-Packet  Time  Stamp,  IRIG  106  Ch  4  Binary 


struct  SuIntrPacketTimc_lb88Time 
{ 

uint32_t  uNanoSeconds;  //  Nano-seconds 

uint32_t  uSeconds;  //  Seconds 

}; _ 

Figure  5-8.  Intra-Packet  Time  Stamp,  IEEE-1588 


struct  SuIIntrPacketTime  ERTCTime 
1 

uint32  t  uLSLW;  //  Least  significant  long  word 

uint32  t  uMSLW;  //  Most  significant  long  word 

};  _ 

Figure  5-9.  Intra-Packet  Time  Stamp,  64-bit  ERTC 

5.5.1  Type  0x00,  Computer-Generated  Data,  Fonnat  0 

Computer-Generated  Data,  Format  0  packets  are  used  to  store  data  generated  internally 
by  a  recorder.  The  data  packet  begins  with  the  CSDW  shown  in  Figure  5-10.  The  data  portion 
of  the  data  packet  is  undefined  and  left  to  the  discretion  of  the  recorder  manufacturer. 


struct  SuCompGenO  ChanSpec 
{ 

uint32_t  uReserved; 

}; _ 

Figure  5-10.  Type  0x00  Computer-Generated  Data,  Format  0  (User)  CSDW 

5.5.2  Type  0x01,  Computer-Generated  Data,  Fonnat  1  (Setup  Record) 

Computer-Generated  Data,  Format  1  packets  are  used  to  store  the  TMATS  recorder 
configuration  record.  The  data  packet  begins  with  the  CSDW  shown  in  Figure  5-11. 
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struct  SuTmats 

{ 

uint32  t 

ChanSpec 

iChlOVer 

:  8; 

// 

Recorder 

Ch  10  Version 

uint32  t 

bConf igChange 

:  l; 

// 

Recorder 

config  changed 

uint32  t 

bXMLFo rmat 

:  l; 

// 

XML  Format  Used 

uint32  t 

} ; 

iReserved 

:  22; 

// 

Reserved 

Figure  5-11.  Type  0x01  Computer-Generated  Data,  Format  1  (Setup)  CSDW 


Note  that  this  structure  definition  for  the  CSDW  first  appeared  in  106-07.  Since  unused 
fields  are  required  to  be  zero  filled,  data  files  prior  to  106-07  will  have  a  value  of  zero  in  the 
iChlOVer  field. 

The  first  data  packet  in  a  Chapter  10  data  file  must  be  a  TMATS  setup  record.  Under 
certain  conditions,  TMATS  setup  records  may  also  be  found  later  in  the  same  recorded  data  file. 
In  particular,  subsequent  TMATS  records  may  occur  during  network  data  streaming  of  Chapter 
10  data  to  allow  network  data  users  to  leam  the  recorder  configuration  after  recording  and 
streaming  has  begun.  The  bConf  igChanged  flag  is  used  to  indicate  whether  this  TMATS 
setup  record  is  different  than  the  previous  TMATS  setup  record  (i.e.,  the  recorder  configuration 
changed)  or  whether  it  duplicates  the  previous  TMATS  setup  record. 

The  data  that  follows  the  CSDW  in  the  data  packet  is  the  TMATS  setup  information  in 
Chapter  9  fonnat. 

5.5.3  Type  0x02,  Computer-Generated  Data,  Format  2  (Recording  Events) 

Computer-Generated  Data,  Format  2  packets  are  used  to  record  the  occurrence  of  events 
during  a  recording  session.  Event  criteria  are  defined  in  the  TMATS  setup  record.  Note  that  a 
recorded  event  is  different  and  distinct  from  a  Chapter  6  .EVENT  command.  A  .EVENT 
command  may  result  in  a  Recording  Event  packet  if  it  has  been  defined  in  the  TMATS  setup 
record. 


The  layout  of  the  CSDW  is  shown  in  Figure  5-12.  The  uEventCount  field  is  a  count 
of  the  total  number  of  events  in  this  packet.  The  blntraPckHdr  field  indicates  the  presence 
of  the  optional  intra-packet  data  header  (IPDH)  in  the  IPH. 


struct  SuEvents 

ChanSpec 

l 

uint32  t 

uEventCount 

:  12; 

// 

Total 

number 

of  events 

uint32  t 

uReserved 

:  19; 

uint32  t 

1; 

blntraPckHdr 

:  1; 

// 

Intra 

-packet 

header  present 

Figure  5-12.  Type  0x02  Computer-Generated  Data,  Format  2  (Events)  CSDW 


There  is  a  number  of  permutations  of  the  recorded  event.  In  fact,  there  are  enough 
permutations  that  it  makes  sense  to  represent  the  data  message  layout  in  non-specific  terms. 
Later,  during  packet  processing,  generic  data  fields  can  be  cast  to  their  specific  formats.  Event 
data  without  optional  data  (blntraPckHdr  =  0 )  is  shown  in  Figure  5-13.  Event  data  with 
optional  data  (blntraPckHdr  =  1)  is  shown  in  Figure  5-14.  The  format  for  the  event 
message  itself  is  shown  in  Figure  5-15. 
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struct  SuEvents 
{ 

uint64_t  suIntraPckTime;  //  Intra-packet  time  stamp 

struct  SuEvents  Data  suData;  //  Data  about  the  event 

} ; 

Figure  5-13.  Type  0x02  Computer-Generated  Data,  Format  2  (Events)  Message 

without  Optional  Data 


struct  SuEvents_with_Optional 
{ 

uint64  L  suIntraPckTime; 

uint64_t  suTntrPckData ; 

struct  SuEvents  Data  suData; 

) ; 


//  Intra-packet  time  stamp 
//  Intra-packet  data 

//  Data  about  the  event 


Figure  5-14.  Type  0x02  Computer-Generated  Data,  Format  2  (Events)  Message 

with  Optional  Data 


struct  SuEvents 

{ 

uint32  t 

Data 

uNumber 

12; 

// 

Event 

identification  number 

uint32  t 

uCount 

16; 

// 

Event 

count  index 

uint32  t 

bEventOccurence 

1; 

// 

uint32  t 

}; 

uReserved 

3; 

// 

Time 

tag  bits 

Figure  5-15.  Type  0x02  Computer-Generated  Data,  Format  2  (Events)  Message 

Data 


The  suIntraPckTime  field  in  the  data  structures  of  Figure  5-13  and  Figure  5-14 
represents  event  time  in  either  48-bit  relative  time  format  derived  from  the  RTC  (fonnat  shown 
in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted 
48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in  Figure  5-8),  or 
ERTC  time  (format  shown  in  Figure  5-9). 

If  the  event  message  includes  the  optional  suIntrPckData  IPDH  field,  shown  in  the 
data  structure  of  Figure  5-14,  this  field  holds  the  absolute  time  of  the  event.  The  format  of  this 
data  is  the  same  as  the  Time  Data  Packet  Fonnat  1,  depicted  in  Figure  5-16  and  Figure  5-17. 
Unfortunately  Time  Data  Packet  Format  1  represents  time  in  more  than  one  format  and  this  data 
format  does  not  include  a  method  to  determine  which  time  format  is  used  in  the  IPDH.  For  this 
reason,  this  field  should  be  used  with  caution,  if  used  at  all. 


struct  SuTimeFl 

{ 

uint32  t 

ChanSpec 

uTimeSrc 

4; 

// 

Time 

source 

uint32  t 

uTimeFmt 

4; 

// 

Time 

format 

uint32  t 

bLeapYear 

1; 

// 

Leap 

year 

uint32  t 

uDateFmt 

1; 

// 

Date 

format 

uint32  t 
uint32  t 

); 

uReservedl 

uReserved2 

2; 

16; 

Figure  5-16.  Type  0x11  Time  Data,  Format  1  CSDW 
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//  Time  message  -  Day  format 

struct  SuTime 
{ 

uintl6  t 

MsgDayFmt 

uTmn 

4 

// 

Tens  of  milliseconds 

uintl6  t 

uHmn 

4 

// 

Hundreds  of  milliseconds 

uintl6  t 

uSn 

4 

// 

Units  of  seconds 

uintl6  t 

uTSn 

3 

// 

Tens  of  seconds 

u inti  6  t 

Reservedl 

1 

// 

0 

uinLlG  L 

uMn 

4 

// 

Units  of  minutes 

uintl6  t 

uTMn 

3 

// 

Tens  of  minutes 

uintlG  t 

Reserved2 

1 

// 

0 

u inti 6  t 

uHn 

4 

// 

Units  of  hours 

uintl6  t 

uTIIn 

2 

// 

Tens  of  Hours 

uintlG  t 

Reserved3 

2 

// 

0 

uintl6  t 

uDn 

4 

// 

Units  of  day  number 

uintl6  t 

uTDn 

4 

// 

Tens  of  day  number 

uintl6  t 

uHDn 

2 

// 

Hundreds  of  day  number 

uintl6  t 
}; 

Reserved4 

6 

// 

0 

Figure  5-17.  Type  0x1 1  Time  Data,  Format  1  Structure,  Day  Format 


Data  about  the  recorded  event  is  found  in  the  SuEvents_Data  structure  shown  in 
Figure  5-15.  The  particular  event  is  identified  by  the  uNumber  field,  which  corresponds  to  the 
recording  event  index  number  (i.e.,  the  “n”  value  in  “R-x\EV\  ID-n”)  in  the  TMATS  setup 
record  for  this  recording.  The  uCount  field  is  incremented  each  time  this  event  occurs.  The 
bEventOccurence  field  indicates  whether  the  event  occurred  during  or  between  record 
enable  commands. 

5.5.4  Type  0x03,  Computer-Generated  Data,  Format  3  (Recording  Index) 

Computer-Generated  Data,  Format  3  packets  record  file  offset  values  that  point  to  various 
important  data  packets  in  the  recording  data  file.  Chapter  10  data  files  can  be  very  large,  and  it’s 
generally  impractical  to  search  for  specific  data  without  an  index  of  some  sort.  Currently 
recording  index  packets  are  used  to  index  the  position  of  time  packets  and  event  packets  to  make 
it  easy  to  move  to  a  specific  time  or  event  in  the  data  file;  however,  nothing  precludes  the  use  of 
index  packets  to  index  other  data  packet  types. 

Index  entries  are  organized  into  a  two-tier  tree  structure  of  root  index  packets  and  node 
index  packets.  A  node  index  entry  contains  information  (e.g.,  packet  type,  channel,  offset)  about 
the  specific  data  packet  to  which  it  points.  Multiple  index  entries  are  contained  in  a  node  index 
type  of  index  packet.  A  root  index  type  of  index  packet  is  used  to  point  to  node  index  packets  in 
the  data  file.  Index  packets  (root  and  node)  can  be  stored  anywhere  in  a  data  file  with  the 
exception  that  the  final  root  index  packet  must  be  the  last  data  packet  in  a  data  file.  The  presence 
of  indexing  is  also  indicated  by  the  TMATS  field  “R-x\IDX\E”  having  a  value  of  “T”  (i.e., 
“true”);  however,  note  that  it  is  currently  not  unusual  to  find  a  TMATS  IDX  value  of  false,  but 
find  a  valid  root  node  packet  at  the  end  of  the  data  file. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-18,  and  is  a  common  format  between  root 
and  node  index  packets.  The  uldxEntCount  field  is  a  count  of  the  total  number  of  indexes  in 
this  packet.  The  blntraPckHdr  field  indicates  the  presence  of  the  optional  IPDH.  The 
bFileSize  field  indicates  the  presence  of  the  optional  file  size  field.  The  ulndexType  field 
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indicates  whether  the  indexes  that  follow  are  root  or  node  indexes.  If  file  size  is  present,  it 
follows  the  CSDW  as  an  unsigned  64-bit  value. 


struct  Sulndex 

{ 

uint32  t 

ChanSpec 

uldxEntCount 

16; 

// 

Total  number  of  indexes 

uint32  t 

uReserved 

13; 

uint32  t 

blntraPckHdr 

1; 

// 

Intra-packet  header  present 

uint32  t 

bFileSize 

l; 

// 

File  size  present 

uint32  t 

1; 

ulndexType 

l; 

// 

Index  type 

Figure  5-18.  Type  0x03  Computer-Generated  Data,  Format  3  (Index)  CSDW 


Node  index  packets  are  composed  of  a  CSDW,  an  optional  file  size  field,  and  multiple 
node  index  structures. 

Each  node  index  structure  is  composed  of  an  intra-packet  time  stamp  (IPTS),  an  optional 
IPDH,  and  a  node  index  entry  data  structure.  The  IPTS  represents  indexed  packet  data  time  in 
either  48-bit  relative  time  format  derived  from  the  RTC  (format  shown  in  Figure  5-6)  or  as 
absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format 
shown  in  Figure  5-7),  IEEE-1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (fonnat 
shown  in  Figure  5-9). 

If  the  index  message  includes  the  optional  IPDH  field,  this  field  holds  the  absolute  time 
of  the  index.  The  format  of  this  data  is  the  same  as  the  Time  Data  Packet  Format  1,  depicted  in 
Figure  5-16  and  Figure  5-17.  Unfortunately  Time  Data  Packet  Format  1  represents  time  in  more 
than  one  format  and  this  data  format  does  not  include  a  method  to  determine  which  time  format 
is  used  in  the  IPDH.  For  this  reason,  this  field  should  be  used  with  caution,  if  used  at  all. 

The  structure  of  the  node  index  entry  is  shown  in  Figure  5-19.  The  uChannellD  field 
is  the  Channel  ID  of  the  indexed  data  packet.  The  uDataType  field  is  the  data  type  of  the 
indexed  data  packet.  The  uOf  f  set  field  is  an  unsigned  eight-byte  value  representing  the  offset 
from  the  beginning  of  the  data  file  to  the  indexed  data  packet.  The  uOf  f  set  field  should 
always  point  to  the  sync  pattern  (0xEB25)  of  the  indexed  data  packet. 


struct  Sulndex 

{ 

uint32  t 

Data 

uChannellD 

:  16; 

uint32  t 

uDataType 

:  8; 

uint32  t 

uReserved 

:  8; 

uint64  t 

1; 

uOf fset; 

Figure  5-19.  Type  0x03  Computer-Generated  Data,  Format  3  (Index)  Node 

Index  Entry 

Root  index  packets  are  composed  of  a  CSDW,  an  optional  file  size  field,  and  multiple 
root  index  entry  structures.  Root  index  structures  provide  information  about  and  point  to  node 
index  packets  described  above.  The  last  entry  is  actually  a  pointer  to  the  previous  root  index. 
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Each  root  index  is  composed  of  an  IPTS,  an  optional  IPDH,  and  a  node  index  data  packet 
offset  value.  The  IPTS  represents  indexed  packet  data  time  in  either  48-bit  relative  time  format 
derived  from  the  RTC  (format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute 
time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (fonnat  shown  in  Figure  5-7),  IEEE-1588  time 
(format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 

If  the  root  index  message  includes  the  optional  IPDH  field,  this  field  holds  the  absolute 
time  of  the  node  index  packet.  The  format  of  this  data  is  the  same  as  the  Time  Data  Packet 
Format  1,  depicted  in  Figure  5-16  and  Figure  5-17.  Unfortunately  Time  Data  Packet  Format  1 
represents  time  in  more  than  one  format  and  this  data  format  does  not  include  a  method  to 
determine  which  time  format  is  used  in  the  IPDH.  For  this  reason,  this  field  should  be  used  with 
caution,  if  used  at  all. 

The  node  index  offset  field  of  the  root  index  packet  is  an  eight-byte  unsigned  value 
representing  the  offset  from  the  beginning  of  the  data  file  to  the  node  index  packet. 

5.5.5  Type  0x04  -  0x07,  Computer-Generated  Data,  Format  4  -  Format  7 

Reserved  for  future  use. 

5.5.6  Type  0x08,  Pulse  Code  Modulation  (PCM)  Data,  Format  0 
Reserved  for  future  use. 

5.5.7  Type  0x09,  PCM  Data,  Format  1  (IRIG  106  Chapter  4/8) 

Format  1  PCM  packets  are  used  to  record  pulse  code  modulation  (PCM)  data  frames. 
Most  PCM  data  is  a  serial  stream  of  bits  from  multiple  interleaved  data  sources.  Each  data 
source  generally  operates  at  a  different  data  rate  and  has  its  digital  data  interleaved  in  a  fixed, 
defined  fashion.  The  data  from  these  multiplexed  data  sources  are  organized  into  major  frames 
and  minor  frames.  Fonnat  1  PCM  data  records  minor  frames  as  integral  units  of  data  in  packed 
and  unpacked  mode.  In  general  the  PCM  data  packet  will  contain  multiple  PCM  minor  frame 
data  messages.  There  is  extensive  discussion  of  PCM  in  IRIG  106  Chapter  4, 12  Chapter  8, 13  and 
Appendix  C,14  as  well  as  RCC  Document  1 19,  Telemetry  Applications  Handbook}5 

A  PCM  minor  frame  is  recorded  in  one  of  three  major  modes:  unpacked,  packed,  and 
throughput.  In  unpacked  mode,  packing  is  disabled  and  each  data  word  is  padded  with  the 
number  of  filler  bits  necessary  to  align  the  first  bit  of  each  word  with  the  next  16-bit  boundary  in 
the  packet.  In  packed  mode,  packing  is  enabled  and  pad  is  not  added  to  each  data  word; 


12  Range  Commanders  Council.  “Pulse  Code  Modulation  Standards”  in  Telemetry  Standards.  IRIG  106-15  Chapter 
4.  July  2015.  May  be  superseded  by  update.  Retrieved  10  August  2016.  Available  at 
http://www.wsmr.army.mil/RCCsite/Documents/106-15  Telemetry  Standards/Chapter4.pdf. 

13  Range  Commanders  Council.  “Digital  Data  Bus  Acquisition  Formatting  Standard”  in  Telemetry ?  Standards.  IRIG 
106-15  Chapter  8.  July  2015.  May  be  superseded  by  update.  Retrieved  10  August  2016.  Available  at 
http://www.wsmr.armv.mil/RCCsite/Documents/106-15  Telemetry  Standards/Chapter8.pdf. 

14  Range  Commanders  Council.  “Pulse  Code  Modulation  Standards  (Additional  Information  and 
Recommendations)”  in  Telemetry  Standards.  IRIG  106-15  Appendix  C.  July  2015.  May  be  superseded  by  update. 
Retrieved  10  August  2016.  Available  at  http://www.wsmr. army, mil/RCCsite/Documents/106- 

15  Telemetry  Standards/ AppendixC.pdf. 

15  Range  Commanders  Council.  Telemetry  Applications  Handbook.  RCC  119-06.  May  2006.  May  be  superseded 
by  update.  Retrieved  10  August  2016.  Available  at  http://www.wsmr.army.mi1/RCCsite/Documents/l  19- 
06  Telemetry  Applications  Handbook/. 
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however,  filler  bits  may  be  required  to  maintain  minor  frame  alignment  on  word  boundaries.  In 
throughput  mode,  the  PCM  data  are  not  frame  synchronized  so  the  first  data  bit  in  the  packet  can 
be  any  bit  in  the  major  frame.  Chapter  10  discusses  these  modes  in  greater  detail. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-20.  The  uSyncOf  f  set  field  is  the  value 
of  the  byte  offset  into  a  major  frame  for  the  first  data  word  in  a  packet,  and  is  only  valid  in 
packed  mode.  The  bUnpackedMode,  bPackedMode,  and  bThruMode  flags  indicate 
unpacked  mode,  packed  mode,  and  throughput  mode  respectively  and  are  mutually  exclusive. 
The  bAlignment  flag  indicates  16-  or  32-bit  alignment  of  minor  frames  and  minor  frame 
fields.  The  uMa  jorFrStatus  field  indicates  the  lock  status  of  the  major  frame.  The 
uMinorFrStatus  indicates  the  lock  status  of  the  minor  frame.  The  bMinorFrlnd  flag 
indicates  the  first  word  of  the  packet  is  the  beginning  of  a  minor  frame.  The  bMajorFrlnd 
flag  indicates  the  first  word  of  the  packet  is  the  beginning  of  a  major  frame.  The 
blntraPckHdr  flag  indicates  the  presence  of  IPHs. 


struct  SuPcmFl_ChanSpec 
{ 


uint32 

_t 

uSyncOf fset 

18; 

// 

Sync  offset 

uint32 

_t 

bUnpackedMode 

1; 

// 

Unpacked  mode  flag 

uint32 

t 

bPackedMode 

1; 

// 

Packed  mode  flag 

uint32’ 

_t 

bThruMode 

1; 

// 

Throughput  mode  flag 

uint32 

t 

bAl ignment 

1; 

// 

16/32  bit  alignment  flag 

uint32 

_t 

Reservedl 

2; 

// 

uint32 

t 

uMa jorFrStatus 

2; 

// 

Major  frame  lock  status 

uint32 

_t 

uMinorFrStatus 

2; 

// 

Minor  frame  lock  status 

uint32 

_t 

bMinorFrlnd 

1; 

// 

Minor  frame  indicator 

uint32 

t 

bMajorFrlnd 

l; 

// 

Major  frame  indicator 

uint32 

t 

blntraPckHdr 

1; 

// 

Intra-packet  header  flag 

uint32 

t 

Reserved2 

1; 

// 

} _ 

Figure  5-20.  Type  0x09  PCM  Data,  Format  1  CSDW 

The  optional  IPH  and  individual  PCM  minor  frame  messages  follow  the  CSDW.  The 
format  of  the  IPDH  is  shown  in  Figure  5-21.  The  IPDFI,  if  present  (indicated  by 
blntraPckHdr  =  1),  is  an  eight-byte  representation  of  time  in  either  48-bit  relative  time 
format  derived  from  the  RTC  (format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is 
absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (fonnat  shown  in  Figure  5-7),  IEEE- 
1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9).  The 
uMa  jorFrStatus  field  indicates  the  lock  status  of  the  major  frame.  The  uMinorFrStatus 
indicates  the  lock  status  of  the  minor  frame. 


struct  SuPcmFlHeader 
{ 


uint64 

t 

suIntraPckTime; 

// 

Reference  time 

uint32 

_t 

Reserved 

:  12; 

// 

uint32 

t 

uMaj or Fr Status 

:  2; 

// 

Major 

frame  lock 

status 

uint32 

_t 

uMinorFrStatus 

:  2; 

// 

Minor 

frame  lock 

status 

uint32 

}; 

_t 

Reserved 

:  16; 

// 

Figure  5-21.  Type  0x09  PCM  Data,  Format  1  Intra-Packet  Data  Header 
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One  minor  frame  of  data  follows  the  IPDH.  The  length  of  the  minor  frame  data  is  not 
included  in  the  data  packet.  The  data  length  must  be  determined  from  the  number  of  bits  in  a 
minor  frame  specified  in  the  TMATS  parameter  P-d\MF2.  Minor  frames  will  have  padding  bits 
added  to  the  end  to  make  them  16-  or  32-bit  aligned  depending  on  the  value  of  the 
bAlignment  flag  in  the  CSDW.  Refer  to  the  TMATS  P-d  format  descriptions  in  Chapter  9  of 
the  106. 

5.5.8  Type  OxOA,  OxOF  PCM  Data,  Fonnat  2  -  Fonnat  7 
Reserved  for  future  use. 

5.5.9  Type  0x10,  Time  Data,  Format  0 
Reserved  for  future  use. 

5.5.10  Type  0x11,  Time  Data.  Format  1  (IRIG/GPS/RTC) 

Time  is  recorded  in  a  data  file  much  like  any  other  data  source.  The  purpose  of  the  Time 
Data,  Format  1  packet  is  to  provide  a  correlation  between  an  external  clock  source  and  the 
recorder  internal  10-MHz  RTC.  The  correlation  between  the  RTC  and  clock  time  is  described  in 
more  detail  in  Section  5.6. 

The  time  data  packet  begins  with  the  CSDW  shown  in  Figure  5-22. 


struct  SuTimeFl 

/ 

ChanSpec 

i 

uint32  t 

uTimeSrc 

4 

// 

Time 

source 

uint32  t 

uTimeFmt 

4 

// 

Time 

format 

uint32  t 

bLeapYear 

1 

// 

Leap 

year 

uint32  t 

uDateFmt 

1 

// 

Date 

format 

uint32  t 

uReservedl 

2 

uint32  t 

uReserved2 

16 

1; 

Figure  5-22.  Type  0x11  Time  Data,  Format  1  CSDW 


The  uTimeSrc  field  indicates  that  the  source  is  for  the  time  used.  Note  that  this  field 
changed  slightly  between  the  2004  and  the  2005  release  of  Chapter  10.  The  uTimeFmt  field  is 
used  to  indicate  the  nature  and  type  of  the  source  of  external  time  applied  to  the  recorder.  The 
uDateFmt  field  is  used  to  detennine  how  to  interpret  the  time  data  that  follows.  Time 
representation  in  Day  (i.e.,  Day  of  the  Year)  fonnat  is  shown  in  Figure  5-23.  Time 
representation  in  Day-Month- Year  format  is  shown  in  Figure  5-24.  The  bLeapYear  field  in 
the  CSDW  is  useful  to  convert  Day  of  the  Year  to  Day  and  Month  when  the  year  is  not  known. 
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//  Time  message  -  Day  format 
struct  SuTime_MsgDayFmt 
{ 


uintlfi 

t 

uTmn 

4 ; 

// 

Tens  of  milliseconds 

uintl6 

t 

utlmn 

4; 

// 

Hundreds  of  milliseconds 

uintlfi 

t 

uSn 

4; 

// 

Units  of  seconds 

uintl6 

_t 

uTSn 

3; 

// 

Tens  of  seconds 

uintl6 

t 

Reservedl 

1; 

// 

0 

uintl6 

"t 

uMn 

4; 

// 

Units  of  minutes 

uintlfi 

t 

uTMn 

3; 

// 

Tens  of  minutes 

uintl6 

~t 

Reserved2 

1; 

// 

0 

uintl6 

't 

uHn 

4; 

// 

Units  of  hours 

uintlfi 

’t 

uTHn 

2; 

// 

Tens  of  Hours 

uintlfi 

\ 

Reserved3 

2; 

// 

0 

uintl 6 

t 

uDn 

4; 

// 

Units  of  day  number 

uintlfi 

"t 

uTDn 

4; 

// 

Tens  of  day  number 

uintlfi 

t 

uHDn 

2; 

// 

Hundreds  of  day  number 

uintl 6 

}; 

"t 

Reserved4 

6; 

// 

0 

Figure  5-23.  Type  0x11  Time  Data,  Format  1  Structure,  Day  Format 


//  Time  message  -  DMY  format 
struct  SuTime_MsgDmyFmt 
{ 


uintl6 

t 

uTmn 

4; 

// 

Tens  of  milliseconds 

uintl6 

t 

uHmn 

4; 

// 

Hundreds  of  milliseconds 

uintl6 

t 

uSn 

4; 

// 

Units  of  seconds 

uintl6 

t 

uTSn 

3; 

// 

Tens  of  seconds 

uintl6 

t 

Reservedl 

1; 

// 

0 

uintl6 

t 

uMn 

4; 

// 

Units  of  minutes 

uintl6 

t 

uTMn 

3; 

// 

Tens  of  minutes 

uintl6 

t 

Reserved2 

1; 

// 

0 

uintl6 

t 

uHn 

4; 

// 

Units  of  hours 

uintl 6 

t 

uTHn 

2; 

// 

Tens  of  Hours 

uintl6 

_t 

Reserved3 

2; 

// 

0 

uintl6 

t 

uDn 

4; 

// 

Units  of  day  number 

uintl6 

t 

uTDn 

4; 

// 

Tens  of  day  number 

uintl6 

t 

uOn 

4; 

// 

Units  of  month  number 

uintl6 

_t 

uTOn 

1; 

// 

Tens  of  month  number 

uintl6 

t 

Reserved4 

3; 

// 

0 

uintl6 

t 

uYn 

4; 

// 

Units  of  year  number 

uintl6 

_t 

uTYn 

4; 

// 

Tens  of  year  number 

uintl6 

t 

uHYn 

4; 

// 

Hundreds  of  year  number 

uintl6 

t 

uOYn 

2; 

// 

Thousands  of  year  number 

uintl6 

t 

Reserved5 

2; 

// 

0 

} ; 

Figure  5-24.  Type  0x11  Time  Data,  Format  1  Structure,  DMY  Format 

5.5.11  Type  0x12  -  0x17,  Time  Data,  Format  2  -  Format  7 
Reserved  for  future  use. 

5.5.12  Type  0x18,  MIL-STD-1553  Data,  Format  0 
Reserved  for  future  use. 
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5.5.13  Type  0x19.  MIL-STD-1553  Data.  Format  1  (MIL-STD-1553B  Data! 

Format  1  MIL-STD-1553  data  packets  are  used  to  record  the  MIL-STD-1553  message 
transactions  on  a  bus.  In  general  the  1553  data  packet  will  contain  multiple  1553  messages. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-25.  The  uMsgCnt  field  indicates  the 
number  of  messages  contained  in  the  data  packet.  The  uTTB  field  indicates  the  1553  message 
bit  to  which  the  time  tag  corresponds. 


struct  Sul553Fl_ChanSpec 
{ 


uint32 

t 

uMsgCnt 

:  24; 

// 

Message  count 

uint32 

t 

Reserved 

:  6; 

uint32 

1; 

t 

uTTB 

:  2; 

// 

Time  tag  bits 

Figure  5-25.  Type  0x19  MIL-STD-1553  Data,  Format  1  CSDW 


The  individual  1553  messages  follow  the  CSDW.  Each  1553  message  has  an  IPTS,  an 
IPH  data  word,  and  then  the  actual  1553  message.  The  layout  of  the  message  header  is  shown  in 
Figure  5-26.  The  suIntPktTime  field  is  an  eight-byte  value.  The  specific  interpretation  of 
this  field  is  determined  by  packet  header  flags.  This  time  is  interpreted  as  an  RTC  value  as 
depicted  in  Figure  5-6  if  secondary  headers  are  not  enabled  bit  six  of  the  packet  flag  word.  If 
secondary  headers  are  enabled,  then  the  format  of  the  IPTS  is  the  same  as  the  secondary  header, 
determined  by  bits  two  and  three  of  the  packet  flags  word.  These  formats  are  depicted  in  Figure 
5-7,  Figure  5-8,  and  Figure  5-9.  Various  bit  flags  and  values  are  found  in  the  IPDH. 


//  Intra-message  header 

struct  Sul553Fl 

{ 

uint64  t 

Header 

suIntPktTime; 

// 

Reference  time 

uintl6  t 

Reservedl 

3; 

// 

Reserved 

uintl6  t 

bWordError 

1; 

uintl6  t 

bSyncError 

1; 

uintl6  t 

bWordCntError 

1; 

uint!6  t 

Reserved2 

3; 

uintl6  t 

bRespTimeout 

1; 

uintl6  t 

bFormatError 

1; 

uintl6  t 

bRT2RT 

1; 

uint!6  t 

bMsgError 

1; 

uintl6  t 

iBusID 

1; 

uintl6  t 

Reserved3 

2; 

uint8  t 

uGapTimel ; 

uint8  t 

uGapTime2 ; 

uintl6  t 

}; 

uMsgLen; 

Figure  5-26.  Type  0x19  MIL-STD-1553  Data,  Fonnat  1  Intra-Packet  Header 


The  amount  of  data  that  follows  the  IPH  is  variable.  The  data  length  in  bytes  is  given  in 
the  uMsgLen  field  and  is  necessary  to  determine  the  amount  of  additional  data  to  read  to 
complete  the  message. 
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The  layout  and  order  of  1553  command  word(s),  status  word(s),  and  data  word(s)  in  the 
recorded  1553  message  is  not  fixed  but  rather  is  the  same  as  it  would  be  found  “on  the  wire”.  It's 
not  therefore  possible  to  define  a  fixed  data  structure  representation  for  the  message  data.  The 
first  word  in  the  data  will  always  be  a  command  word,  but  it  will  be  necessary  to  use  the 
command  word  as  well  as  the  bRT2RT  flag  to  determine  the  offsets  of  the  other  message 
structures  such  as  the  status  and  data  word(s).  The  layouts  of  the  various  types  of  1553  messages 
are  shown  in  Figure  5-27.  When  calculating  data  word  count,  be  careful  to  take  Mode  Codes  and 
word  count  wrap  around  into  account.  An  algorithm  to  determine  the  number  of  data  words  in  a 
message  is  shown  in  C-like  pseudo-code  in  Figure  5-28. 


BC-+RT 

RT  — >  BC 

RT  — >  RT 

Mode  Code 
without  Data 

Transmit  Mode 
Code  with  Data 

Receive  Mode 
Code  with  Data 

Command  Word 

Command  Word 

Command  Word 

Mode  Command 

Mode  Command 

Mode  Command 

Data  Word  1 

Status  Word 

Command  Word 

Status  Word 

Status  Word 

Data  Word 

•  •  • 

Data  Word  1 

Status  Word 

Data  Word 

Status  Word 

Data  Word  n 

•  •  • 

Data  Word  1 

Status  Word 

Data  Word  n 

•  •  • 

Data  Word  n 

Status  Word 

Figure  5-27.  1553  Message  Word  Layout 


// 

Mode  Code  case 

if 

(Subaddress  =  0x0000)  or 

(Subaddress  = 

0x001 f) 

if  (WordCount  &  0x0010) 

DataWordCount 

=  1 

else 

DataWordCount 

=  0 

// 

Non-Mode  Code  case 

el 

se 

if  (WordCount  =  0) 

DataWordCount 

=  32 

else 

DataWordCount 

=  WordCount 

Figure  5-28.  Algorithm  to  Detennine  1553  Data  Word  Count 


5.5.14  Type  0x1  A,  MIL-STD-1553  Data.  Format  2  ( 16PP 194  Bus) 

Format  2  of  MIL-STD-1553  packets  is  used  to  record  data  from  the  16PP194  data  bus. 
The  16PP194  data  bus  is  used  as  the  F-16  weapons  multiplex  bus.  It  is  defined  in  document 
16PP362A  Weapons  MUX  (WMUX)  Protocol.16  A  16PP194  transaction  consists  of  six  32-bit 
words  consisting  of  a  16PP194  Command,  Command  Echo,  Response,  GO/NOGO,  GO/NOGO 
Echo,  and  Status  as  illustrated  in  Figure  5-29.  Multiple  transactions  may  be  encoded  into  the 
data  portion  of  a  single  packet. 


16  Lockheed  Martin  Corporation.  “Advanced  Weapons  Multiplex  Data  Bus.”  8  June  2010.  May  be  superseded  by 
update.  Retrieved  3  June  2015.  Available  to  RCC  members  with  Private  Portal  access  at 
https://wsdmext.wsmr.army.mil/site/rccpri/Limited  Distribution  References/ 16PP362B.pdf. 
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(1) 


(2) 


(4) 


(5) 


TX 


Command 


Command 

ECHO 


GO  NOGO 


GONOGO 

ECHO 


(3) 


(6) 


RX 


Response 


STATUS 


Figure  5-29.  16PP194  Message  Transaction 


The  layout  of  the  CSDW  is  show  in  Figure  5-30.  The  16PP194  packet  can  contain 
multiple  bus  transactions.  The  uMsgCnt  field  indicates  the  number  of  16PP194  messages  in  the 
packet. 


struct  Sul553F2_ChanSpec 
{ 

uint32_t  uMsgCnt;  //  Message  count 

}; _ 

Figure  5-30.  Type  OxlA  MIL-STD-1553  Data,  Format  2  (16PP194)  CSDW 

The  16PP194  message  word  is  26  bits  in  length  and  consists  of  16  data  bits,  4  address 
bits,  4  sub-address  bits,  a  parity  bit,  and  a  sync  bit.  Only  the  24  bits  of  data,  address,  and  sub¬ 
address  values  are  mapped  into  the  16PP194  recorded  data  word.  Sync  and  parity  bits  are  not 
recorded.  The  mapping  of  these  bits  is  shown  in  Figure  5-3 1 . 


MSB 


LSB 


16PP194  32-bit  Intra-Packet  Word  Format  (as  it  appears  in  the  data 
packet) 


Figure  5-31.  16PP194  to  IRIG  106  Chapter  10  Data  Bit  Mapping 


The  layout  of  the  recorded  16PP194  word  is  shown  in  Figure  5-32.  The  uDataWord 
field  contains  the  message  data.  The  uRiuSubAddr  field  is  the  remote  interface  unit  (RIU) 
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sub-address.  The  uRiuAddr  field  is  the  RIU  address.  The  bParityError  flag  indicates  a 
parity  error  occurred  during  reception  of  the  message.  The  bWordError  flag  indicates  a 
Manchester  decoding  error  occurred  during  reception  of  the  message.  The  uGap  field  indicates 
the  general  range  of  gap  time.  The  mapping  of  uGap  values  to  gap  time  ranges  can  be  found  in 
the  Chapter  10  standard.  The  uBusID  field  indicates  the  bus  on  which  the  message  occurred. 
Bus  identification  can  be  found  in  the  Chapter  10  standard.  The  layout  of  a  complete  16PP194 
transaction  is  shown  in  Figure  5-33. 


struct  SuSul6PPl94  Word 

uint32 

t 

uDataWord; 

16;  // 

Data  word  contents 

uint32 

t 

uRiuSubAddr 

4 

// 

RIU  Sub  Address 

uint32 

t 

uRiuAddr 

4 

// 

RIU  Terminal  Address 

uint32 

t 

bParityError 

1 

// 

Parity  error  flag 

uint32 

t 

bWordError 

1 

// 

Manchester  error  flag 

uint32 

t 

uGap 

3 

// 

Gap  time  indicator 

uint32 

1; 

t 

uBusID 

3 

// 

Bus  ID  indicator 

Figure  5-32.  16PP194Word  Layout 


struct  Sul6PP194  Transaction 


1 

struct  Sul6PP194_Word 
struct  Sul6PP194_Word 
struct  Sul6PP194J/tford 
struct  Sul6PP194_Word 
struct  Sul6PP194_Word 
struct  Sul6PP194  Word 


suCommand; 

suResponse; 

suCommandEcho ; 

suNoGo; 

suNoGoEcho; 

suStatus; 


Figure  5-33.  16PP194  Transaction  Layout 


5.5.15  Type  OxlB  -  OxlF,  MIL-STD-1553  Data,  Format  3  -  Format  7 
Reserved  for  future  use. 

5.5.16  Type  0x20,  Analog  Data,  Format  0 
Reserved  for  future  use. 

5.5.17  Type  0x21,  Analog  Data,  Format  1  (Analog  Data) 

Analog  Data,  Format  1  packets  are  used  to  record  digitized  analog  signals.  In  general  the 
analog  data  packet  will  contain  multiple  digitized  values  from  multiple  analog  channels. 
Digitized  signal  values  can  be  stored  in  either  a  unpacked  or  packed  fashion.  Unpacked  storage 
is  where  each  sample  occupies  one  16-bit  word  with  unused  bits  zero-filled.  Packed  storage 
concatenates  samples  to  use  the  least  amount  of  storage  possible,  but  samples  will  straddle  16-bit 
word  boundaries. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-34.  Analog  packets  may  have  one  or 
multiple  CSDWs.  If  all  analog  subchannels  are  the  same  then  the  bSame  value  will  equal  “1” 
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and  only  one  CSDW  will  be  present.  If  subchannels  are  configured  differently  then  there  will  be 
one  CSDW  for  each  subchannel.  The  uMode  field  indicates  whether  the  samples  are  stored  in 
packed  or  unpacked  mode  and  how  unused  bits  are  zero-filled.  The  uLength  field  indicates  the 
number  of  bits  in  the  digitized  sample.  The  uSubChan  field  indicates  the  number  of  the  current 
subchannel.  The  uTotChan  field  indicates  the  total  number  of  subchannels  in  the  packet.  The 
uFactor  field  indicates  the  exponent  of  the  power  of  2  as  a  sampling  rate  factor  denominator. 


struct  SuAnalogFl  ChanSpec 

l 

uint32  t 

uMode 

2 

// 

uint32  t 

uLength 

6 

// 

Bits  in  A/D  value 

uint32  t 

uSubChan 

8 

// 

Subchannel  number 

uint32  t 

uTotChan 

8 

// 

Total  number  of  subchannels 

uint32  t 

uFactor 

4 

// 

Sample  rate  exponent 

uint32  t 

bSame 

1 

// 

One/multiple  CSDW 

uint32  t 
}; 

iReserved 

3 

// 

Figure  5-34.  Type  0x21  Analog  Data,  Format  1  CSDW 


Sample  rate,  least  significant  bit  value,  offset,  and  other  analog  parameters  are  recorded 
in  the  TMATS  packet.  The  layout  of  the  sequential  samples  is  described  in  detail  in  the  Chapter 
10  standard. 

5.5.18  Type  0x22  -  0x27,  Analog  Data,  Format  2  -  Format  7 
Reserved  for  future  use. 

5.5.19  Type  0x28,  Discrete  Data,  Fonnat  0 
Reserved  for  future  use. 

5.5.20  Type  0x29,  Discrete  Data,  Fonnat  1  (Discrete  Data) 

Discrete  Data,  Format  1  packets  are  used  to  record  the  state  of  discrete  digital  signals.  In 
general  the  discrete  data  packet  will  contain  multiple  values  from  multiple  discrete  events. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-35.  The  uRecordState  and 
uAlignment  flags  are  components  of  the  discrete  packet  mode  field.  See  the  Chapter  10 
standard  for  further  details.  The  uLength  value  is  the  number  of  discrete  bits  that  follow  in  the 
packet. 


struct  SuDiscreteFl  ChanSpec 
1 


uint32  t 

uRecordState 

1 

// 

uint32  t 

uAlignment 

1 

// 

uint32  t 

uReservedl 

1 

// 

uinL32  t 

uLength 

5 

// 

uint32  t 
}; 

uReserved2 

24 

// 

Figure  5-35.  Type  0x29  Discrete  Data,  Format  1  CSDW 
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The  layout  of  the  Discrete  Data  message  is  shown  in  Figure  5-36.  Each  message  contains 
a  time  stamp  and  the  state  of  the  discrete  data  input  signals.  The  suIntraPckTime  field  in 
the  data  structures  represents  event  time  in  either  48-bit  relative  time  format  derived  from  the 
RTC  (format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either 
Chapter  4  weighted  48-bit  time  (format  shown  in  F4gureJC7),  IEEE- 1588  time  (format  shown  in 
Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 


struct  SuDiscreteFl 

{ 

uint64  t 

suIntraPckTime; 

// 

Intra-packet  time  stamp 

uint32  t 

} ; 

suData; 

// 

Data  about  the  event 

Figure  5-36.  Type  0x29  Discrete  Data,  Format  1  Message 


Versions  of  Chapter  10  prior  to  the  2009  release  incorrectly  stated  that  bit  7  of  the  packet 
flags  (in  the  packet  header)  is  used  to  detennine  if  the  intra-packet  time  is  relative  time  or 
absolute  time.  The  correct  bit  to  use  is  bit  6. 

5.5.21  Type  0x2A  -  0x2F,  Discrete  Data,  Format  2  -  Format  7 

Reserved  for  future  use. 

5.5.22  Type  0x30,  Message  Data,  Format  0  (Generic  Message  Data) 

Message  Data  packets  are  used  to  record  data  from  sources  that  do  not  have  a  defined 
packet  type  in  the  Chapter  10  standard.  Examples  of  this  might  be  the  H-009  bus  found  on  older 
F-15  aircraft  or  the  high-speed  data  bus  found  on  older  F-16  aircraft.  The  Chapter  10  standard 
implies  that  Message  Data  packets  represent  “serial”  communications  data.  In  practice,  there  are 
few  restrictions  on  the  content  or  source  of  the  data  for  Message  Data  packets. 

Message  Data  packets  do  not  contain  any  field  to  indicate  what  fonnat  or  type  of  data 
they  contain  or  how  to  interpret  the  data  contents.  Message  Data  packets  are  distinguished  by 
their  Channel  ID  and  Subchannel  values.  The  TMATS  setup  provides  fields  specifying  a 
subchannel  name  (R-x\MCNM-n-m)  for  each  subchannel  number  (R-x\MSCN-m-n)  and 
Channel  ID  (R-x\TKl-m).  Use  the  subchannel  name  to  detennine  how  to  decode  each  Channel 
ID/subchannel  combination.  There  currently  is  no  standard  for  subchannel  names  and  no 
registry  of  “well-known”  names. 

Individual  Message  Data  messages  are  restricted  to  no  more  than  65,535  bytes  (64 
kilobytes  [kb]).  A  Message  Data  packet  can  contain  multiple  data  messages,  a  single  data 
message,  or  a  segment  of  a  large  (>64  kb)  data  message.  A  Message  Data  packet  consists  of  a 
CSDW  followed  by  one  or  more  messages.  The  layout  of  the  CSDW  is  shown  in  Figure  5-37. 
The  uType  value  indicates  whether  the  data  is  a  complete  message  or  a  segment  of  a  large 
message.  The  uCounter  value  indicates  either  the  number  of  data  packets  to  follow  or,  for  the 
segmented  case,  the  segment  number  of  the  large  data  packet  segment  that  follows. 
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struct  SuMcssagcF0_ChanSpcc 
{ 


uint32 

_t 

uCounler 

:  16; 

// 

Message/segment  counter 

uint32 

t 

uType 

:  2; 

// 

Complete/segment  type 

uint.32 

t 

uReserved 

:  14; 

}  SuMessaqeK0_ChanSpec; 

Figure  5-37.  Type  0x30  Message  Data,  Format  0  CSDW 

The  layout  of  the  Message  Data  message  IPFI  is  shown  in  Figure  5-38.  Each  header 
contains  a  time  stamp  and  some  additional  information  about  the  data  that  follows  in  the 
message.  The  suIntraPckTime  field  in  the  intra-packet  data  structure  represents  event  time 
in  either  48-bit  relative  time  fonnat  derived  from  the  RTC  (fonnat  shown  in  Figure  5-6)  or  as 
absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format 
shown  in  Figure  5-7),  IEEE-1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format 
shown  in  Figure  5-9).  The  uMsgLength  value  indicates  the  number  of  data  bytes  in  the 
message.  The  uSubChannel  value  identifies  the  specific  subchannel  from  which  this  data 
came.  The  message  data  immediately  follows  the  IPFI.  Note  that  an  even  number  of  bytes  is 
allocated  for  message  data.  If  the  data  contains  an  odd  number  of  bytes,  then  one  unused  filler 
byte  is  inserted  at  the  end  of  the  data.  The  bFmtError  and  bDataError  flags  indicate  that 
errors  have  occurred  in  the  reception  of  the  data.  The  recorded  data  may,  therefore,  be  invalid 
and  unusable. 


struct  SuMe 

{ 

uint64 

S  5 

ageFO  Header 

t 

suIntraPckTime; 

// 

Reference  time 

uint32 

t 

uMsgLength 

16; 

// 

Message  length 

uint32 

t 

uSubChannel 

14; 

// 

Subchannel  number 

uint32 

t 

bFmtError 

1; 

// 

Format  error  flag 

uint32 

1; 

t 

bDataError 

1; 

// 

Data  error  flag 

Figure  5-38.  Type  0x30  Message  Data,  Format  0  Intra-Packet  Header 


5.5.23  Type  0x31  -  0x37,  Message  Data,  Format  1  -  Format  7 
Reserved  for  future  use. 

5.5.24  Type  0x38.  ARINC  429  Data,  Format  0  (ARINC429  Data) 

Format  0  ARINC  429  data  packets  are  used  to  record  data  messages  from  an  ARINC  429 
data  bus.  The  ARINC  429  standard17  defines  a  unidirectional  data  bus  commonly  found  on 
commercial  and  transport  aircraft.  Words  are  32  bits  in  length  and  most  messages  consist  of  a 
single  data  word.  Messages  are  transmitted  at  either  12.5  or  100  kbit/s  from  a  transmitting 
system  to  one  or  more  receiving  systems.  The  transmitter  is  always  transmitting  either  32-bit 
data  words  or  the  NULL  state.  An  ARINC  data  packet  can  contain  multiple  messages. 


17  Aeronautical  Radio,  Inc.  Mark  33  Digital  Information  Transfer  System  (DITS).  ARINC  429. 
Annapolis:  ARINC,  1995. 
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The  layout  of  the  CSDW  is  shown  in  Figure  5-39.  The  uMsgCount  field  indicates  the 
number  of  recorded  ARINC  429  messages. 


struct  SuArinc429F0  ChanSpec 

1 

uint32  t  uMsgCount 

:  16; 

//  Message  count 

uint32  t  Reserved 

1; 

:  16; 

// 

Figure  5-39.  Type  0x60  ARINC  429  Data,  Format  0  CSDW 


Individual  ARINC  429  data  messages  follow  the  CSDW.  Each  message  is  preceded  with 
an  IPDH  followed  by  the  ARINC  429  data  word. 

The  layout  of  the  ARINC  429  data  message  IPDH  is  shown  in  Figure  5-40.  The 
uGapTime  field  is  the  time  between  the  beginning  of  the  preceding  bus  word  and  the  beginning 
of  the  current  bus  word  in  0. 1 -microsecond  increments.  The  uBusSpeed  field  indicates  the  bit 
rate  of  the  recorded  bus  message.  The  bParityError  flag  indicates  the  presence  of  a  parity 
data  error.  The  bFormatError  flag  indicates  the  presence  of  one  of  several  types  of  data 
format  errors.  The  uBusNum  field  identifies  the  specific  ARINC  429  bus  associates  with  the 
recorded  data  message. 


struct  SuArinc42 9F0_Header 
{ 


uint32  t 
uint32  t 

uGapTime 

Reserved 

20 

1 

//  Gap  Time 
// 

uint32_t 

uBusSpeed 

1 

//  Bus  Speed 

uint32_t 

bParityError 

1 

//  Parity  Error 

uint32  t 

bFormatError 

1 

//  Data  type 

uint32  t 

uBusNum 

8 

//  Bus  number 

} ; 


Figure  5-40.  Type  0x38  ARINC  429  Data,  Format  0  Intra-Packet  Data  Header 


The  layout  of  the  individual  ARINC  429  data  work  is  shown  in  Figure  5-41.  Refer  to  the 
ARINC  429  standard  for  the  interpretation  of  the  specific  data  fields. 


struct  SuArinc42 9F0_Data 
{ 


uint32 

t 

uLabel 

8; 

// 

Label 

uint32_ 

_t 

uSDI 

2; 

// 

Source /Destination 

uint32 

_t 

uData 

19; 

// 

Data 

uint32_ 

USSM 

2; 

// 

Sign/Status  Matrix 

uint32 

}; 

_t 

uParity 

1; 

// 

Parity 

Figure  5-41.  Type  0x38  ARINC  429  Data  Format 


5.5.25  Type  0x39  -  0x3F,  ARINC  429  Data,  Format  1  -  Format  7 
Reserved  for  future  use. 
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5.5.26  Type  0x40,  Video  Data,  Format  0  (MPEG-2/H.264  Video) 

Video  Data,  Format  0  packets  are  used  to  record  digitized  video  and  associated  audio 
signals.  Format  0  packets  are  restricted  to  contain  only  MPEG-2  transport  stream  (TS)  packets. 
Video  can  be  encoded  with  either  MPEG-2  Main  Profile  Main  Level  encoding  or  H.264  (also 
known  as  MPEG-4  Part  10  and  MPEG-4  Advanced  Video  Coding  [AVC])  Main  Profile  Level  3 
encoding.  The  H.264  standard18  is  usually  the  preferred  encoder  for  lower  bit  rate  video.  This 
encoding  is  usually  referred  to  as  Standard  Definition  (SD)  and  has  a  maximum  resolution  of  720 
by  576  pixels  but  is  frequently  less. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-42.  The  uType  value  indicates  the 
specific  video  encoding  type  in  the  MPEG-2  stream.  This  field  was  first  defined  in  IRIG  106-07 
(Data  Version  0x03).  It  was  reserved  and  zero  filled  in  previous  versions  of  Chapter  10.  The 
bKLV  flag  indicates  the  presence  of  key-length-value  (KLV)  metadata  fields  in  the  video  data. 
The  bSRS  flag  indicates  whether  or  not  the  embedded  video  clock  is  synchronized  with  the 
RTC.  The  blntraPckHdr  flag  indicates  the  presence  of  IPH  data  in  each  video  data  message. 
The  bET  flag  indicates  the  presence  of  embedded  time  in  the  video  data. 


struct  SuVideoFOChanSpec 
1 


uint32  t 
uint32  t 

Reserved 

uType 

24; 

4; 

// 

Payload  type 

uint32  t 

bKLV 

1; 

// 

KLV  present 

uint32  t 

bSRS 

l; 

// 

SCR/RTC  Sync 

uint32  t 

blntraPckHdr 

l; 

// 

Intra-Packet  Header 

uint32  t 

bET 

1; 

// 

Embedded  Time 

}; _ 

Figure  5-42.  Type  0x40  Video  Data,  Format  0  CSDW 

All  TS  packets  follow  the  CSDW.  All  TS  packets  are  a  fixed  size  of  188  bytes.  If  the 
blntraPckHdr  flag  is  set,  each  TS  packet  will  be  preceded  with  an  eight-byte  IPTS.  The 
intra-packet  time  represents  TS  time  in  either  48-bit  relative  time  format  derived  from  the  RTC 
(format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either 
Chapter  4  weighted  48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in 
Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9).  Format  0  does  not  include  a  packet 
count.  Instead  the  number  of  TS  packets  can  be  calculated  from  the  size  of  the  data  packet  found 
in  the  Chapter  10  header. 

Format  0  video  data  can  be  readily  decoded  with  commonly  available  MPEG  libraries 
such  as  the  open-source  fftnpeg  library.  A  188-byte  TS  packet  is  best  thought  of  as  a  contiguous 
stream  of  1504  bits.  All  TS  packets  are  stored  in  Format  0  packets  as  a  series  of  16-bit  words. 
The  first  Format  0  data  word  holds  the  first  16  TS  packet  bits.  The  first  TS  packet,  or  bit  0,  is  the 
left-most  bit  (most  significant  bit)  in  the  first  Format  0  packet  word.  Note  that  the  description  of 
this  bit-ordering  alignment  in  a  Format  0  packet  has  been  frequently  depicted  wrong  in  the 
various  IRIG  106  Chapter  10  releases.  Most  MPEG  decoder  libraries  such  as  fftnpeg  commonly 


18  International  Telecommunications  Union  Telecommunication  Standardization  Sector.  “Advanced  Video  Coding 
for  Generic  Audiovisual  Services.”  ITU-T  H.264.  February  2016.  May  be  superseded  by  update.  Retrieved  4 
August  2016.  Available  at  http://www.itu.int/rec/T-REC-H.264-201602-I/en. 
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take  as  input  a  188-byte  array  of  TS  data.  Due  to  the  use  of  16-bit  words  to  store  TS  data  in 
Format  0  packets,  TS  data  needs  to  be  byte-swapped  as  it  is  read  from  a  Chapter  10  data  file  and 
put  into  a  buffer  for  decoding  by  a  software  library  expecting  byte-aligned  TS  data. 

5.5.27  Type  0x41,  Video  Data,  Format  1  (ISO  13818-1  MPEG-2) 

Video  Data,  Format  1  packets  are  used  to  record  digitized  video  and  associated  audio 
signals.  Format  1  packets  can  support  the  complete  MPEG-2  ISO/IEC  1 38 1 8- 1 :20 1 5 19  standard 
for  both  program  streams  (PSs)  and  TSs.  Any  profile  and  level  combination  can  be  used  in 
Format  1. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-43.  The  uPacketCnt  value  is  the 
number  of  MPEG-2  packets  in  the  data  packet.  The  uType  value  indicates  whether  the  video 
packet  is  a  PS  or  TS.  The  uMode  value  indicates  whether  the  video  packet  uses  constant  or 
variable  rate  encoding.  The  bET  flag  indicates  the  presence  of  embedded  time  in  the  video  data. 
The  uEPL  value  indicates  the  video  packet  encoding  profile  and  level  used.  The 
blntraPckHdr  flag  indicates  the  presence  of  IPH  data  in  each  video  data  message.  The  bSRS 
flag  indicates  whether  or  not  the  embedded  video  clock  is  synchronized  with  the  RTC.  The 
bKLV  flag  indicates  the  presence  of  KLV  metadata  fields  in  the  video  data. 


struct  SuVideoFI 

{ 

uint32  t 

ChanSpec 

uPacketCnt 

12; 

// 

Number  of  packets 

uint32  t 

uType 

l; 

// 

TS/PS  type 

uint32  t 

uMode 

l; 

// 

Const/Var  mode 

uint32  t 

bET 

1; 

// 

Embedded  Time 

uint32  t 

uEPL 

4; 

// 

Encoding  Profile  and  Level 

uint32  t 

blntraPckHdr 

1; 

// 

Intra-Packet  Header 

uint32  t 

bSRS 

1; 

// 

SCR/RTC  Sync 

uint32  t 

bKLV 

l; 

// 

KLV  present 

uint32  t 

1; 

uReserved 

10; 

Figure  5-43.  Type  0x40  Video  Data,  Format  1  CSDW 


The  CSDW  is  followed  by  MPEG-2  PS  or  TS  packets.  All  TS  packets  are  a  fixed  length 
of  188  bytes,  but  PS  packers  are  variable  length.  If  the  blntraPckHdr  flag  is  set,  each 
MPEG-2  packet  will  be  preceded  with  an  eight-byte  IPTS.  The  intra-packet  time  represents 
MPEG  packet  time  in  either  48-bit  relative  time  format  derived  from  the  RTC  (format  shown  in 
Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted 
48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in  Figure  5-8),  or 
ERTC  time  (format  shown  in  Figure  5-9). 

Format  1  does  not  include  a  method  to  separate  individual  MPEG  packets  from  within  the 
Format  1  packet  other  than  determining  the  MPEG  packet  size  from  the  MPEG  packet  data. 
Determining  MPEG  packet  size  is  fairly  complicated  and  involves  quite  a  bit  of  knowledge  about 


19  International  Organization  for  Standardization/International  Electrotechnical  Commission.  Information 
Technology  -  Generic  Coding  of  Moving  Pictures  and  Associated  Audio  Information:  Systems.  ISO/IEC  13818- 
1:2015.  July  2015.  Retrieved  4  August  2016.  Available  for  purchase  at 
http://www.iso.org/iso/home/store/catalogue  ics/catalogue  detail  ics.htm?csnumber=67331. 
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MPEG  internal  data  structures.  For  this  reason,  the  use  of  IPHs  between  MPEG  packets  should 
be  carefully  considered.  It  could  make  decoding  Format  1  packets  quite  complicated. 

5.5.28  Type  0x42.  Video  Data.  Fonnat  2  (ISO  14496  MPEG-4  Part  10  AVC/H.264) 

Video  Data,  Format  2  packets  are  used  to  record  digitized  video  and  associated  audio 
signals.  Fonnat  2  packets  can  support  the  complete  MPEG-2  ISO/IEC  13818-1:2015  standard 
for  both  PSs  and  TSs,  and  provides  all  H.264  (also  known  as  MPEG-4  Part  10  and  MPEG-4 
A  VC)  encoding  levels  and  profdes. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-44.  The  uPacketCnt  value  is  the 
number  of  MPEG-2  packets  in  the  data  packet.  The  uType  value  indicates  whether  the  video 
packet  is  a  PS  or  TS.  The  uMode  value  indicates  whether  the  video  packet  uses  constant  or 
variable  rate  encoding.  The  bET  flag  indicates  the  presence  of  embedded  time  in  the  video  data. 
The  uEP  value  indicates  the  video  packet  encoding  profile  used.  The  blntraPckHdr  flag 
indicates  the  presence  of  IPH  data  in  each  video  data  message.  The  bSRS  flag  indicates  whether 
or  not  the  embedded  video  clock  is  synchronized  with  the  RTC.  The  bKLV  flag  indicates  the 
presence  of  KLV  metadata  fields  in  the  video  data.  The  uEL  value  indicates  the  video  packet 
encoding  profile  and  level  used.  The  uAET  field  indicates  the  type  of  AVC/H.264  audio 
encoding  used. 


struct  SuVideoF2  ChanSpec 
{ 


uint32 

t 

uPacketCnt 

12 

// 

Number  of  packets 

uint32 

t 

uType 

1 

// 

TS/PS  type 

uint32 

t 

uMode 

1 

// 

Const/Var  mode 

uint32 

t 

bET 

1 

// 

Embedded  Time 

uint32 

t 

uEP 

4 

// 

Encoding  Profile 

uint32 

t 

blntraPckHdr 

1 

// 

Intra-Packet  Header 

uint32 

t 

bSRS 

1 

// 

SCR/ RTC  Sync 

uint32 

t 

bKLV 

1 

// 

KLV  present 

uint32 

t 

uEL 

4 

// 

Encoding  Level 

uint32 

t 

uAET 

1 

// 

Audio  Encoding  Type 

uint32 

1; 

t 

uReserved 

5 

Figure  5-44.  Type  0x40  Video  Data,  Format  2  CSDW 


The  CSDW  is  followed  by  MPEG-2  PS  or  TS  packets.  All  TS  packets  are  a  fixed  length 
of  188  bytes,  but  PS  packers  are  variable  length.  If  the  blntraPckHdr  flag  is  set,  each 
MPEG-2  packet  will  be  preceded  with  an  eight-byte  IPTS.  The  intra-packet  time  represents 
MPEG  packet  time  in  either  48-bit  relative  time  format  derived  from  the  RTC  (format  shown  in 
Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted 
48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in  Figure  5-8),  or 
ERTC  time  (format  shown  in  Figure  5-9). 

Format  2  does  not  include  a  method  to  separate  individual  MPEG  packets  from  within  the 
Format  2  packet  other  than  determining  the  MPEG  packet  size  from  the  MPEG  packet  data. 
Determining  MPEG  packet  size  is  fairly  complicated  and  involves  quite  a  bit  of  knowledge  about 
MPEG  internal  data  structures.  For  this  reason,  the  use  of  IPHs  between  MPEG  packets  should 
be  carefully  considered.  It  could  make  decoding  Format  2  packets  quite  complicated. 
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5.5.29  Type  0x43  -  0x47,  Video  Data,  Format  3  -  Format  7 
Reserved  for  future  use. 

5.5.30  Type  0x48,  Image  Data,  Format  0  (Image  Data) 

Image  Data,  Format  0  packets  are  used  to  record  digitized  video  images. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-45.  The  uLength  value  is  the  number  of 
bytes  in  each  segment.  The  blntraPckHdr  flag  indicates  the  presence  of  the  IPDH.  The 
uSum  value  indicates  if  and  how  an  image  is  segmented  in  the  data  packet.  The  uPart  value 
indicates  which  part  of  a  possibly  segmented  image  is  contained  in  the  data  packet. 


struct  SuImaqeFO 
/ 

ChanSpec 

i 

uint32  t 

uLength 

:  27; 

// 

Segment  byte  length 

uint32  t 

blntraPckHdr 

:  1; 

// 

Intra-packet  header  flag 

uint32  t 

uSum 

:  2; 

// 

uint32  t 
}; 

uPart 

:  2; 

// 

Figure  5-45.  Type  0x48  Image  Data,  Format  0  CSDW 


Individual  image  data  messages  follow  the  CSDW.  Each  message  may  have  an  optional 
IPDH  followed  by  the  image  data.  The  IPDH,  if  present  (indicated  by  blntraPckHdr  =  1),  is 
an  eight-byte  representation  of  time  in  either  48-bit  relative  time  format  derived  from  the  RTC 
(format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either 
Chapter  4  weighted  48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in 
Figure  5-81,  or  ERTC  time  (format  shown  in  Figure  5-9) 

The  format  of  the  image  data  portion  of  the  packet  is  not  specified  in  Chapter  10.  The 
image  format  is  specified  in  the  TMATS  setup  record  attribute  “R-x\SIT-n”.  Note  that  an 
even  number  of  bytes  is  allocated  for  message  data.  If  the  data  contains  an  odd  number  of  bytes, 
then  one  unused  filler  byte  is  inserted  at  the  end  of  the  data. 

5.5.31  Type  0x49,  Image  Data,  Format  1  (Still  Imagery) 

Image  Data,  Format  1  packets  are  used  to  record  digitized  still  images.  Several  formats 
for  image  compression  are  supported  by  Format  1 . 

The  layout  of  the  CSDW  is  shown  in  Figure  5-46.  The  uFormat  value  indicates  the 
format  of  the  image  data.  The  blntraPckHdr  flag  indicates  the  presence  of  the  IPDH.  The 
uSum  value  indicates  if  and  how  an  image  is  segmented  in  the  data  packet.  The  uPart  value 
indicates  which  part  of  a  possibly  segmented  image  is  contained  in  the  data  packet. 
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struct  SuImageFt 
{ 

uint32  t 

ChanSpec 

uReserved 

23; 

// 

uint32  t 

uFormat 

4; 

// 

Image  format 

uint32  t 

blntraPckHdr 

1; 

// 

Intra-packet  header  flag 

uint32  t 

uSum 

2; 

// 

uint32  t 

1; 

uPart 

2; 

// 

Figure  5-46.  Type  0x49  Image  Data,  Format  1  CSDW 


Individual  image  data  messages  follow  the  CSDW.  Each  message  may  have  an  optional 
IPDH  (indicated  by  blntraPckHdr  =  1)  followed  by  the  image  data.  The  format  of  the  IPDH 
is  shown  in  Figure  5-47.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time 
in  either  48-bit  relative  time  fonnat  derived  from  the  RTC  (fonnat  shown  in  Figure  5-6)  or  as 
absolute  time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format 
shown  in  Figure  5-7),  IEEE-1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format 
shown  in  Figure  5-9)  The  uMsgLength  value  indicates  the  length  of  the  following  still  image 
or  segment. 


struct  SulmageFl  Header 

{ 

uint64  t  suIntraPckTime; 

// 

Reference  time 

uint32  t  uMsgLength; 

}; 

// 

Message  length 

Figure  5-47.  Type  0x49  Image  Data,  Format  1  Intra-Packet  Header 


5.5.32  Type  0x4A  -  0x4F,  Image  Data,  Fonnat  2  -  Format  7 

Reserved  for  future  use. 

5.5.33  Type  0x50,  Universal  Asynchronous  Receiver  and  Transmitter  (UART)  Data,  Format  0 

Format  0  UART  packets  are  used  to  record  character  data  from  an  asynchronous  serial 
interface.  In  general  the  UART  data  packet  will  contain  multiple  buffers  of  serial  data.  The 
Chapter  10  standard  has  no  provisions  for  specifying  how  characters  will  be  grouped  into  blocks 
of  data  other  than  the  100-millisecond  maximum  data  block  time.  It  is  common  for  recorder 
vendors  to  provide  a  mechanism  for  determining  serial  message  boundaries  and  recording  a 
complete  serial  message  into  a  single  UART  data  message  based  on  detecting  “dead  time” 
between  messages. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-48.  The  blntraPckHdr  flag  is  used  to 
indicate  if  an  optional  IPTS  is  included  with  each  UART  data  message. 


struct  SuUartFO  ChanSpec 
1 

uint32  t  uReserved  :  31; 

uint32_t  blntraPckHdr  :  1 

}  SuUartF0_ChanSpec; 

Figure  5-48.  Type  0x50  UART  Data,  Format  0  CSDW 
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The  UART  Data  message  may  have  an  optional  IPTS.  If  so,  this  time  field  will  be  an 
eight-byte  value.  Time  is  represented  in  either  48-bit  relative  time  fonnat  derived  from  the  RTC 
(format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either 
Chapter  4  weighted  48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in 
Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 

The  layout  of  the  UART  Data  message  IPDH  is  shown  in  Figure  5-49.  The 
uDataLength  value  indicates  the  number  of  data  bytes  in  the  message.  The  uSubChannel 
value  identifies  the  specific  subchannel  this  data  came  from.  The  message  data  immediately 
follows  the  IPDH.  Note  that  an  even  number  of  bytes  is  allocated  for  UART  data.  If  the  data 
contains  an  odd  number  of  bytes,  then  one  unused  filler  byte  is  inserted  at  the  end  of  the  data. 
The  bParityError  flag  indicate  that  errors  have  occurred  in  the  reception  of  the  data.  The 
recorded  data  may,  therefore,  be  invalid  and  unusable. 


struct  SuUartFO 

DataHeader 

1 

uintl6  t 

uDataLength 

:  16; 

//  Num  of  bytes  of  UART  data 

uintl6  t 

uSubChannel 

:  14; 

//  Subchannel  for  following  data 

uintl6  t 

uReserved 

:  1; 

uintl6  t 

); 

bParityError 

:  1; 

//Parity  Error 

Figure  5-49.  Type  0x40  UART  Data,  Format  0  Intra-Packet  Data  Header 


5.5.34  Type  0x51  -  0x57,  UART  Data,  Format  1  -  Format  7 

Reserved  for  future  use. 

5.5.35  Type  0x58,  IEEE-1394  Data,  Format  0  (IEEE-1394  Transaction) 

Format  0  IEEE- 1394  data  packets  are  used  to  record  data  messages  at  the  transaction 
layer  of  the  IEEE  1394  serial  data  bus.  Currently  IEEE  1394-1995,  IEEE  1394a,  and  IEEE 
1394b  are  supported. 

There  are  two  major  classes  of  IEEE  1394  data  transfer:  synchronous  and  isochronous. 
Synchronous  data  transfer  is  used  to  transport  real-time  data  streams  such  as  video.  Isochronous 
transfer  is  used  to  transport  other  non-time-critical  data  on  a  best-effort  basis  without  latency  or 
throughput  guarantees. 

At  the  lowest  network  level,  IEEE  1394  defines  three  types  of  bus  packets:  a  Physical 
Layer  (PHY)  packet,  a  Primary  packet,  and  an  Acknowledgement  (Ack)  packet.  There  are 
several  different  types  of  Primary  packets.  Primary  packets  contain  a  transaction  code  to 
distinguish  them. 

There  are  three  different  types  of  IEEE- 1394  Data,  Fonnat  0  packets.  The  Chapter  10 
standard  refers  to  these  as  Type  0,  Type  1,  and  Type  2.  Type  0  packets  are  used  to  record  bus 
events  such  as  Bus  Reset.  Type  1  packets  are  used  to  record  synchronous  streams  only  (Primary 
packets  with  a  TCODE  of  OxOA).  Type  2  packets  are  more  general-purpose  and  are  used  to 
record  all  1394  packets  including  PHY,  Primary,  and  Ack  packets. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-50.  The  uPacketType  value  indicates 
the  packet  body  type.  The  uSyncCode  value  is  the  value  of  the  1394  synchronization  code 
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between  transaction  packets.  The  IEEE  1394  standard  describes  the  synchronization  code  as  “an 
application-specific  control  field”  and  “a  synchronization  point  may  be  the  defined  as  boundary 
between  video  or  audio  frames,  or  any  other  point  in  the  data  stream  the  application  may 
consider  appropriate.”  The  uTransCnt  value  is  the  number  of  separate  transaction  messages  in 
the  data  packet. 


struct  Sul394F0 

1 

uint32  t 

ChanSpec 

uTransCnt 

:  16; 

// 

Transaction  count 

uint32  t 

Reserved 

:  9; 

uint32  t 

uSyncCode 

:  4; 

// 

Synchronization  code 

uint32  t 
); 

uPacketType 

:  3; 

// 

Packet  body  type 

Figure  5-50.  Type  0x58  IEEE-1394  Data,  Fonnat  0  CSDW 


Type  0  and  Type  1  data  packets  will  not  have  an  IPH.  Type  2  data  packets  will  have 
IPHs  between  transaction  data  messages  with  the  data  packet.  The  Type  2  IPH  is  an  eight-byte 
time  value.  Time  is  represented  in  either  48-bit  relative  time  format  derived  from  the  RTC 
(format  shown  in  Figure  5-6)  or  as  absolute  time.  If  this  time  is  absolute  time,  it  is  in  either 
Chapter  4  weighted  48-bit  time  (format  shown  in  Figure  5-7),  IEEE- 1588  time  (format  shown  in 
Figure  5-81,  or  ERTC  time  (format  shown  in  Figure  5-9). 

The  IEEE  1394  standards  contain  quite  a  bit  of  example  code  and  data  structures  in  the  C 
language  to  aid  in  data  interpretation. 

5.5.36  Type  0x59,  IEEE-1394  Data,  Format  1  (IEEE-1394  Physical  Layer) 

Format  1  IEEE  1394  data  packets  are  used  to  record  IEEE  1394  at  the  physical  layer.  All 
bus  data  and  bus  events  can  be  recorded  in  Format  1  packets.  The  IEEE-1394  Data,  Format  0, 
Type  2  data  packet  provides  a  similar  capability  for  capturing  all  bus  traffic  at  the  physical  level; 
however,  this  Format  1  packet  provides  more  status  information  and  is  preferred  over  the  Format 
0,  Type  2  data  packet. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-51.  The  uPacketCnt  value  indicates  the 
number  of  separate  1394  data  messages  in  the  data  packet. 


struct  Sul394Fl  ChanSpec 
/ 

1 

uint32  t  uPacketCnt 

:  16; 

//  Number  of  messages 

uint32  t  Reserved 

}; 

:  16; 

Figure  5-51.  Type  0x58  IEEE-1394  Data,  Fonnat  1  CSDW 


Individual  1394  data  messages  follow  the  CSDW.  The  format  of  the  IPDH  is  shown  in 
Figure  5-52.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time  in  either  48- 
bit  relative  time  format  derived  from  the  RTC  (format  shown  in  Figure  5-6)  or  as  absolute  time. 
If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format  shown  in 
Figure  5-71,  IEEE- 1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in 
Figure  5-9).  The  uDataLength  field  is  the  length  of  the  1394  data  message  in  bytes.  The 
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bLBO  flag  indicates  that  some  1394  packets  were  lost  by  the  bus  monitor  due  to  an  overflow  in 
the  local  message  buffer.  The  uTrfOvf  value  indicates  a  1394  transfer  protocol  error.  The 
uStatus  field  indicates  the  value  of  the  eight-bit  bus  status  transfer  from  the  PHY  to  the  link 
layer  of  the  1394  bus.  Bus  status  transfers  are  used  to  signal  a)  bus  reset  indication;  b) 
arbitration  reset  gap  indication  (both  even  and  odd);  c)  subaction  gap  indication;  and  d)  cycle 
start  indication  (both  even  and  odd).  See  IEEE  1394b-200220  Section  17.8  for  more  details  about 
interpreting  uStatus. 


struct  SuIEEE1394Fl  Header 

l 

uint64  t 

suIntraPckTime; 

// 

Reference  time 

uint32  t 

uDataLength 

16; 

// 

Data  length 

uint32  t 

Reserved 

1; 

// 

uint32  t 

bLBO 

l; 

// 

Local  buffer  overflow 

uint32  t 

uTrfOvf 

2; 

// 

Transfer  overflow 

uint32  t 

uSpeed 

4; 

// 

Transmission  speed 

uint32  t 

1; 

uStatus 

8; 

// 

Status  byte 

Figure  5-52.  Type  0x59  IEEE-1394  Data,  Fonnat  1  Intra-Packet  Data  Header 


The  complete  1394  bus  data  message  follows  the  IPDH.  The  length  of  the  1394  data 
message  is  indicated  in  the  IPDH.  If  the  data  length  is  not  a  multiple  of  four,  the  data  buffer  will 
contain  padding  bytes  to  align  the  buffer  on  a  four-byte  boundary.  The  IEEE  1394  standards 
contain  quite  a  bit  of  example  code  and  data  structures  in  the  C  language  to  aid  in  data 
interpretation. 

5.5.37  Type  0x5 A  -  0x5F,  IEEE- 1394  Data,  Format  2  -  Format  7 
Reserved  for  future  use 

5.5.38  Type  0x60,  Parallel  Data,  Format  0 

Parallel  Data,  Fonnat  0  packets  are  used  to  record  data  bits  received  from  a  discrete 
parallel  data  interface.  One  data  word  can  range  from  2  to  128  bits  in  length.  A  parallel  data 
packet  can  contain  multiple  parallel  data  words.  Parallel  Data,  Format  0  packets  support  general- 
purpose  parallel  data  and  parallel  data  from  the  popular  Ampex  Digital  Cartridge  Recording 
System  (DCRsi),  which  is  a  recording  method  and  digital  data  interface  developed  by  Ampex 
Data  Systems.  The  DCRsi  tape  recording  method  is  a  transverse  scan  method  with  the  tape 
heads  embedded  in  the  outer  edge  of  a  spinning  disk  placed  perpendicular  to  the  path  of  the  tape. 
Data,  as  recorded  on  the  DCRsi  cartridge,  is  organized  into  discrete  blocks,  each  assigned  a 
unique  address  number  and  time  stamped  as  it  arrives  at  the  recorder  interface.  The  addressable 
block  size  is  4356  bytes.  The  electrical  interface  is  byte-wide  differential  emitter-coupled  logic. 
A  simplified  depiction  of  the  interface  is  shown  in  Figure  5-53. 


20  Institute  of  Electrical  and  Electronics  Engineers.  IEEE  Standard  for  a  High  Performance  Serial  Bus:  Amendment 
2.  IEEE  1394b-2002.  New  York:  Institute  of  Electrical  and  Electronics  Engineers,  2002. 
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Write  Data 
Write  Clock 
Data  Ready 
Aux  Data 
User  Set 

Read  Data 
Read  Clock 
Data  Valid 
Block  Sync 
Aux  Data  Out 
ECC  Flag 
Buffer  Limit 
Transfer  Ready 


RS232/RS242 
Control  Interface 


Figure  5-53.  Ampex  DCRsi  Interface 


The  layout  of  the  CSDW  is  shown  in  Figure  5-54.  The  uType  field  indicates  the  type  or 
size  of  parallel  data  stored.  For  values  between  2  and  128,  uType  indicates  the  number  of  bits 
per  parallel  data  word.  The  value  254  indicates  that  the  parallel  data  is  in  DCRsi  format.  Other 
values  are  reserved.  When  the  data  type  is  not  DCRsi  the  uScanNum  field  is  reserved  and  will 
have  a  value  of  0x00.  When  the  data  type  is  DCRsi  the  uScanNum  field  contains  the  scan 
number  value  of  the  first  scan  stored  in  the  packet  for  DCRsi  data. 


struct  SuParallelFO  ChanSpec 
{ 

uint32_t  uScanNum  :  24;  //  Scan  number 

uint32_t  uType  :  8;  //  Data  type 

); _ 

Figure  5-54.  Type  0x60  Parallel  Data,  Format  0  CSDW 

Recorded  parallel  data  follows  the  CSDW.  There  is  no  IPH.  For  general-purpose 
packets,  bit  padding  is  used  to  align  recorded  data  on  byte  or  word  boundaries.  There  is  no  count 
for  the  number  of  parallel  data  words  following  the  CSDW.  This  must  be  calculated  from  the 
data  length  in  the  header  and  the  number  of  bytes  per  data  word.  See  the  Chapter  10  standard  for 
complete  details. 

5.5.39  Type  0x61  -  0x67,  Parallel  Data,  Format  1  -  Format  7 
Reserved  for  future  use 
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5.5.40  Type  0x68,  Ethernet  Data,  Format  0 

Format  0  Ethernet  data  packets  are  used  to  record  data  frames  from  an  Ethernet  network. 
In  general,  an  Ethernet  data  packet  will  contain  multiple  captured  Ethernet  data  frames. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-55.  The  uNumFrames  field  indicates  the 
number  of  Ethernet  frames  included  in  this  data  packet.  The  uFormat  field  indicates  the  format 
of  the  captured  Ethernet  frames.  Format  type  0x00  is  described  in  Chapter  10  as  “Ethernet 
Physical  Layer”  but  in  practice  is  better  described  as  “Ethernet  Data  Link  Layer”  because 
support  for  physical  layer  features  such  as  frame  sync  preamble  and  collision  events  are  not 
described  in  the  Chapter  10  standard. 


struct  SuEthernetFO  ChanSpec 

1 

uint32  t 

uNumFrames 

:  16; 

// 

Number 

of 

frames 

uint32  t 

Reservedl 

:  12; 

uint32  t 

); 

uFormat 

:  4; 

// 

Format 

of 

frames 

Figure  5-55.  Type  0x68  Ethernet  Data,  Format  0  CSDW 


Individual  Ethernet  data  messages  follow  the  CSDW.  The  format  of  the  IPDH  is  shown 
in  Figure  5-56.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time  in  either 
48-bit  relative  time  fonnat  derived  from  the  RTC  (format  shown  in  Figure  5-6)  or  as  absolute 
time.  If  this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format  shown  in 
Figure  5-7),  IEEE- 1588  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in 
Figure  5-9). 


struct  SuEthernetF0_Header 
1 


uint64 

_t 

suIntraPckTime ; 

// 

Reference  time 

uint32 

t 

uDataLen 

14; 

// 

Data  length 

uint32 

t 

bLengthError 

l; 

// 

Data  length  error 

uint32 

_t 

bCRCError 

l; 

// 

Data  CRC  error 

uint32 

t 

uNetID 

8; 

// 

Network  identifier 

uint32 

t 

uSpeed 

4; 

// 

Ethernet  speed 

uint32 

t 

uContent 

2; 

// 

Captured  data  content 

uint32 

t 

bFrameError 

l; 

// 

Frame  error 

uint32 

}; 

t 

bFrameCRCError 

1; 

// 

Frame  CRC  error 

Figure  5-56.  Type  0x68  Ethernet  Data,  Format  0  Intra-Packet  Data  Header 


The  uDataLen  field  is  the  length  of  the  Ethernet  data  in  bytes.  The  uNetID  field  is 
used  to  uniquely  identify  the  physical  network  attachment  point.  The  uSpeed  field  indicates 
the  bit  rate  at  which  the  frame  was  captured  by  the  recorder.  Early  coaxial  cable-based  Ethernet 
networks  (10BASE5  and  10BASE2)  required  all  network  participants  to  operate  at  the  same  bit 
rate  since  they  were  sharing  the  same  physical  channel.  Most  modern  Ethernet  network 
topologies  (10BASE-T,  100BASE-TX,  etc.)  are  a  star  configuration  with  a  single  point-to-point 
link  between  the  networked  device  and  a  network  hub.  In  this  case  the  network  bit  rate  is  the  bit 
rate  negotiated  between  the  device  (e.g.,  the  recorder)  and  the  network  hub.  In  this  star  topology 
different  devices  can  operate  at  different  bit  rates  on  the  same  Ethernet  network.  The  uSpeed 
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field  only  indicates  the  bit  rate  of  the  link  the  data  recorder  has  with  the  network  hub.  It  does  not 
imply  the  speed  of  any  other  devices  on  the  network.  The  uContent  field  indicates  the  type  of 
data  payload.  The  media  access  control  (MAC)  content  type  (0x00)  indicates  Ethernet  data  link 
layer  frames,  including  the  destination  address,  source  address,  type  (in  the  case  of  Ethernet  II) 
or  length  (in  the  case  of  IEEE  802.3),  data,  and  frame  check  sequence.  The  data  link  frame 
preamble  is  not  included,  nor  are  other  features  of  the  physical  layer,  such  as  collisions  or  auto¬ 
negotiations.  The  bFrameError  flag  indicates  that  an  unspecified  error  has  occurred  in  the 
reception  of  the  Ethernet  frame. 

5.5.41  Type  0x69  -  0x6F,  Ethernet  Data,  Format  1  -  Format  7 
Reserved  for  future  use 

5.5.42  Type  0x70,  TSPECTS  Data.  Fonnat  0 

Time-space-position  information  (TSPI)  and  Combat  Training  System  (CTS)  position 
information  typically  use  the  Global  Positioning  System  (GPS)  as  their  sources.  Any  GPS  data 
as  defined  by  the  National  Marine  Electronics  Association  (NMEA)  and  Radio  Technical 
Commission  for  Maritime  Services  (RTCM)  standards  will  be  encapsulated  in  the  Format  0 
packet.  The  NMEA  and  RTCM  standards  specify  the  electrical  signal  requirements,  data 
transmission  protocol,  and  message/sentence  formats  for  GPS  data. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-57.  The  IPTS  flag  indicates  whether  the 
IPTS  is  included.  The  Type  field  indicates  the  type  of  the  NMEA-RTCM  data: 

0000  =  NMEA  018321 
0001  =  NMEA  01 83-HS22 
0010  =  NMEA  2000 23 
0011  =  RTCM  SC10424 
0010  -1111=  Reserved 


struct  SuTSPICTSFO  ChanSpec 

uint32  t 

ipts 

:  l; 

// 

IPTS  flag 

uint32  t 

uType 

:  4; 

// 

NMEA-RTCM  data  type 

uint32  t 

1; 

reserved 

:  27; 

Figure  5-57.  Type  0x70  TSPECTS  Data,  Format  0  CSDW 


21  National  Marine  Electronics  Association.  “NMEA  0183  Interface  Standard.”  V4.10.  n.d.  May  be  superseded 
by  update.  Retrieved  10  August  2016.  Available  for  purchase  at 
http://www.nmea.org/content/nmea  standards/nmea  0183  v  4 10, asp. 

22  National  Marine  Electronics  Association.  “NMEA  01 83-HS  Interface  Standard.”  V  1.01.  n.d.  Maybe 
superseded  by  update.  Retrieved  10  August  2016.  Available  for  purchase  at 
http://www.nmea.org/content/nmea  standards/nmea  0183  v  4 10, asp. 

23  National  Marine  Electronics  Association.  “Standard  for  Serial-Data  Networking  of  Marine  Electronic  Devices.” 
Edition  3.101.  March  2016.  May  be  superseded  by  update.  Retrieved  10  August  2016.  Available  for  purchase  at 
http://www.nmea.org/content/nmea  standards/nmea  2000  ed3  10. asp. 

24  Radio  Technical  Commission  for  Maritime  Services.  “Networked  Transport  of  RTCM  via  Internet  Protocol 
(Ntrip).”  RTCM  10410.1.  Version  2.0  Amendment  1.  June  2011.  May  be  superseded  by  update.  Retrieved  10 
August  2016.  Available  for  purchase  at  http://www.rtcm.org/Pub-DGNSS.php. 


5-33 


IR1G  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


Individual  data  messages  follow  the  CSDW.  The  format  of  the  IPDH  is  shown  in  Figure 
5-58.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time  in  either  48-bit 
relative  time  fonnat  derived  from  the  RTC  (fonnat  shown  in  Figure  5-6)  or  as  absolute  time.  If 
this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format  shown  in  Figure 
5-7),  IEEE- 15 88  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 
The  uLength  field  specifies  the  length  of  the  message  in  bytes. 


struct  SuTSPICTSFO  Header 
{ 


uint64 

_t 

suIntraPckTime; 

// 

Reference  time 

uint32 

_t 

Reservedl 

:  16; 

// 

uint32 

1; 

t 

uLength 

:  16; 

// 

Message  length 

Figure  5-58.  Type  0x70  TSPFCTS  Data,  Format  0  Intra-Packet  Data  Header 

5.5.43  Type  0x71,  TSPFCTS  Data,  Fonnat  1 

Air  Combat  Maneuvering  Instrumentation  (ACMI)  data  as  defined  by  the  European  Air 
Group  (EAG)  interface  control  document  (ICD)  DF2912525  for  post-mission  interoperability  will 
be  encapsulated  in  the  Format  1  packet.  The  EAG  ACMI  ICD  defines  the  data  contents  and 
organization.  Electrical  signal  requirements  and  data  transmission  protocol  are  not  defined  in 
DF29125  or  in  the  Chapter  10  format. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-59.  The  IPTS  flag  indicates  whether  the 
IPTS  is  included.  The  uContent  field  indicates  the  type  of  the  EAG  ACMI  data: 

00  =  TSPI  data  only  (no  static  data  or  pod  ID) 

01  =  Contains  pod  ID  and  static  data 


struct  SuTSPICTSEl  ChanSpec 

uint32  t 

ipts 

:  l; 

//  IPTS  flag 

uint32  t 

uContent 

:  2; 

//  EAG  ACMI  data  type 

uint32  t 

reserved 

:  29; 

); 

Figure  5-59.  Type  0x71  TSPI/CTS  Data,  Format  1  CSDW 


Individual  data  messages  follow  the  CSDW.  The  format  of  the  IPDH  is  shown  in  Figure 
5-60.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time  in  either  48-bit 
relative  time  format  derived  from  the  RTC  (fonnat  shown  in  Figure  5-6)  or  as  absolute  time.  If 
this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format  shown  in  Figure 
5-7),  IEEE- 15 88  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 
The  uLength  field  specifies  the  length  of  the  message  in  bytes. 


25  European  Air  Group.  “European  Air  Group  Interface  Control  Document  for  Post  Mission  Interoperability.” 
DF29125  Draft  A  Issue  01.  July  2004.  Retrieved  3  June  2015.  Available  to  RCC  members  with  Private  Portal 
access  at  https://wsdmcxt.wsmr.army.mil/sitc/rccnri/Liinitcd  Distribution  References/DF29 125.pdf. 
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struct  SuTSPICTSFl  Header 
{ 

uint64_t  suIntraPckTime;  //  Reference  time 

uint32  t  Reservedl  :  16;  // 

uint32_t  uLength  :  16;  //  Message  length 

}; _ 

Figure  5-60.  Type  0x71  TSPI/CTS  Data,  Fonnat  1  Intra-Packet  Data  Header 

5.5.44  Type  0x72.  TSPPCTS  Data,  Fonnat  2 

Air  Combat  Test  and  Training  System  (ACTTS)  data  as  defined  by  the  USAF  ACTTS 
interface  specification  WMSP  98-01 26  will  be  encapsulated  in  the  Format  2  packet.  The  ACTTS 
interface  specification  defines  the  unique  signal  interface  requirements  for  the  air-to-air,  air-to- 
ground,  ground-to-air  data  links,  and  aircraft  information  subsystem  recording  fonnats.  The 
ACTTS  WMSP  98-01  establishes  the  requirements  for  the  information  recorded  on  the  different 
data  transfer  units  used  by  the  various  ACTTS  airborne  subsystems  to  support  both  tethered  and 
rangeless  operations. 

When  encapsulating  ACTTS  message/word  format,  data  messages  or  words  will  not  span 
packets.  Each  new  packet  will  start  with  a  full  message  and  not  a  partial  message  or  word. 

The  layout  of  the  CSDW  is  shown  in  Figure  5-61.  The  IPTS  flag  indicates  whether  the 
IPTS  is  included.  The  Format  field  indicates  the  type  of  the  ACTTS  data: 

0000  =  Kadena  Interim  Training  System  (KITS)  Recording  Formats 
0001  =  Alpena  KITS  Recording  Formats 

0010  =  USAF  Europe  Rangeless  Interim  Training  System  Recording  Formats 
0011=  Alaska  Air  Combat  Training  System  (ACTS)  Upgrade  Recording  Formats 
0100  =  Goldwater  Range  Mission  and  Debriefing  System  Recording  Formats 
0101  =  P4RC  Recording  Formats 

0110  =  Nellis  ACTS  Range  Security  Initiative  Recording  Formats 
0111=  P4RC+P5  CTS  Participant  Subsystem  Recording  Formats 

1000  =  P5  CTS  Recording  Formats 

1001  -1111=  Reserved 


struct  SuTSPICTSF2  ChanSpec 
{ 

uint32  t  ipts 

:  l; 

// 

IPTS  flag 

uint32  t 

uFormat 

:  4; 

// 

ACTTS  data  type 

uint32  t 

}; 

reserved 

:  27; 

Figure  5-61.  Type  0x72  TSPECTS  Data,  Format  2  CSDW 


26  Range  Instrumentation  System  Program  Office,  Air  Armament  Center.  “Interface  Specification  for  the  USAF  Air 
Combat  Test  and  Training  System  (ACTTS)  Air-to-Ground,  Air-to-Air,  Ground-to-Air  Data  Links,  and  AIS 
Recording  Formats.”  WMSP  98-01,  Rev  A,  Chg  1.  19  May  2003.  Retrieved  3  June  2015.  Available  to  RCC 
members  with  Private  Portal  access  at 

https://wsdmext.wsmr. armv.mil/site/rccpri/Limited  Distribution  References/WMSP  98-01. doc. 
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Individual  data  messages  follow  the  CSDW.  The  fonnat  of  the  IPDH  is  shown  in  Figure 
5-62.  The  suIntraPckTime  value  is  an  eight-byte  representation  of  time  in  either  48-bit 
relative  time  fonnat  derived  from  the  RTC  (fonnat  shown  in  Figure  5-6)  or  as  absolute  time.  If 
this  time  is  absolute  time,  it  is  in  either  Chapter  4  weighted  48-bit  time  (format  shown  in  Figure 
5-7),  IEEE- 15 88  time  (format  shown  in  Figure  5-8),  or  ERTC  time  (format  shown  in  Figure  5-9). 
The  uLength  field  specifies  the  length  of  the  message  in  bytes. 


struct  SuTSPICTSFl_Header 
1 


uint64 

t 

suIntraPckTime; 

// 

Reference  time 

uint32 

Reservedl 

:  16; 

// 

uint32 

}; 

_t 

uLength 

:  16; 

// 

Message  length 

Figure  5-62.  Type  0x72  TSPFCTS  Data,  Format  2  Intra-Packet  Data  Header 

5.5.45  Type  0x73-0x77,  TSPI/CTS  Data,  Format  3  -  Format  7 
Reserved  for  future  use 

5.5.46  Type  0x78,  Controller  Area  Network  Bus 

Data  from  one  or  more  controller  area  network  (CAN)  bus  interfaces  are  placed  into  a  CAN 
bus  data  packet  fonnat.  The  layout  of  the  CSDW  is  shown  in  Figure  5-63.  The  uMessages 
field  contains  a  binary  value  indicating  the  number  of  messages  included  in  the  packet. 


struct  SuCANBUS  ChanSpec 

1 

uint32_t  reserved  :  16; 

uint32_t  uMessages  :  16;  //  Number  of  messages 

_D _ 

Figure  5-63.  Type  0x78  CAN  Bus  CSDW 

After  the  CSDW,  CAN  bus  data  is  inserted  into  the  packet.  Each  CAN  bus  message  is 
preceded  by  an  IPH  that  has  both  an  IPTS  and  an  intra-packet  message  header  (IPMH)  and  an 
intra-packet  ID  word.  The  length  of  the  IPH  is  fixed  at  16  bytes  (128  bits)  positioned 
contiguously,  with  the  layout  shown  in  Figure  5-64.  The  uSubchannel  field  contains  a  binary 
value  that  represents  the  subchannel  number  belonging  to  the  message  that  follows  the  ID  word 
when  the  channel  ID  in  the  packet  header  defines  a  group  of  subchannels.  Zero  means  first 
and/or  only  subchannel,  which  is  valid  for  the  CAN  bus.  The  uMessageLength  field  contains 
a  binary  value  representing  the  length  of  the  number  of  the  valid  bytes  in  the  rest  of  the  message 
that  follows  the  IPMH.  The  message  length  will  be  4-12  bytes  (4  bytes  for  the  intra-packet  ID 
word  +  0-8  bytes  data  content  of  the  CAN  bus  message).  The  blDE  flag  indicates  whether  to 
use  the  extended  CAN  identifier: 

0=1 1-bit  standard  CAN  identifier  (CAN  ID  word  bits  10-0) 

1  =  29-bit  extended  CAN  identifier  (CAN  ID  word  bits  28-0) 
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struct  SuCANBUS  Header 
{ 


uint64 

_t 

suIntraPckTime; 

// 

Reference  time 

uint32 

t 

bDataError 

l; 

// 

Data  error  flag 

uint32 

_t 

bFormatError 

1; 

// 

Format  error  flag 

uint32 

_t 

Reservedl 

4; 

// 

uint32 

_t 

uSubchannel 

6; 

// 

Subchannel  or  zero  if  N/A 

uint32 

t 

Reserved2 

12; 

// 

uint32 

_t 

uMessage Length 

4; 

// 

Bytes  in  actual  message 

uint32 

t 

bTDE 

1; 

// 

CAN  Identifier 

uint32 

_t 

bRTR 

1; 

// 

Remote  transfer  request  flag 

uint32 

t 

Reserved3 

1; 

// 

uint32 

t 

uCANBusID 

29; 

// 

CAN  Bus  ID 

_D _ 

Figure  5-64.  Type  0x78  CAN  Bus  Intra-Packet  Data  Header 

5.6  Time  Interpretation 

Chapter  10  defines  a  48-bit  RTC  as  the  basis  for  all  packet  and  message  time  stamps. 

The  RTC  clock  is  10  MHz,  resulting  in  a  clock  resolution  of  100  nanoseconds.  There  is  no 
constraint  on  the  absolute  value  of  the  RTC  and  at  recorded  power  on  it  could  be  initialized  to 
zero  or  some  random  number.  Some  recorder  vendors  will  preset  the  RTC  to  a  value  based  on 
absolute  clock  time,  but  for  interoperability  reasons  it  is  unwise  to  assume  the  RTC  value  will  be 
related  to  absolute  clock  time  in  any  meaningful  fashion. 

Absolute  clock  time  comes  into  a  recorder  and  is  recorded  much  like  any  other  data 
source.  In  fact,  there  may  be  multiple  time  sources  recorded.  Time  Data,  Format  1  data  packets 
are  used  to  record  input  time  signals.  Since  Time  Data,  Format  1  packets  contain  both  the 
absolute  input  time  value  and  the  RTC  clock  value  at  the  instant  the  absolute  time  was  valid, 
these  packets  can  be  used  to  relate  RTC  values  to  the  input  absolute  time  source. 

For  example,  if  a  time  packet  is  recorded  with  an  RTC  value  of  1,000,000  and  an 
absolute  time  value  of  100: 12:30:25.000,  then  the  clock  time  of  a  subsequent  data  packet  with  an 
RTC  value  of  1,150,000  could  be  deduced  to  be  100:12:30:25.015  (150,000  clock  tics  x  100 
nanoseconds  per  tic  =  15  milliseconds). 

When  multiple  time  channels  are  available,  it  is  incumbent  on  the  programmer  or  data 
analyst  to  determine  and  select  the  best  source  of  time  for  a  particular  data  set. 

5.7  Index  and  Event  Records 

Often  times  it  is  useful  to  make  an  in-memory  version  of  the  data  file  index.  This  allows 
rapid  access  to  recorded  data  packets  based  on  time  or  the  occurrence  of  events.  Below  is  a 
general  algorithm  for  reading  all  root  and  node  index  packets. 

1.  If  "R-x\IDX\E"  not  equal  to  "T"  then  index  does  not  exist. 

2.  Move  read  pointer  to  last  packet  of  data  file.  Store  file  offset 

of  this  packet. 

3.  If  last  packet  data  type  does  not  equal  0x03  (Computer-Generated 

Data,  Format  3)  then  index  does  not  exist. 

4.  Get  the  index  count  from  the  CSDW. 

5.  For  each  root  index  contained  in  the  packet: 

a.  Read  the  node  index  offset  value. 
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b.  Move  the  read  pointer  to  the  node  index  offset  value. 

c.  Read  the  node  index  packet. 

d.  Get  the  node  index  count  from  the  CSDW. 

e.  For  each  node  index  contained  in  the  packet  read  and  store 
the  time  stamp,  channel  ID,  data  type,  and  data  packet 
offset  values. 

6.  Read  last  root  node  index.  If  offset  value  is  equal  to  current 

root  node  packet  offset  (stored  in  Step  2)  then  done. 

7.  Else  move  read  pointer  to  the  next  root  index  packet  offset 

value . 

8 .  Read  the  next  root  index  packet . 

9.  Go  to  Step  4. 

5.8  Data  Streaming 

Chapter  10  recorders  can  stream  their  data  over  one  of  their  download  interface  network 
ports  using  User  Datagram  Protocol  (UDP)/IP  and  Chapter  10  UDP  transfer  headers.  This  is 
normally  done  over  an  Ethernet  port,  but  any  network  connection  that  supports  UDP/IP  can  use 
this  method. 

The  .  PUBLISH  command  is  used  to  control  data  streaming.  Chapter  6  defines  the  use  of 
.  PUBLISH  and  has  numerous  examples  of  its  use. 

Data  can  be  streamed  to  one  or  more  specific  unicast  and  multicast  IP  addresses  or  a 
broadcast  address.  Different  channels  can  be  addressed  to  different  addresses. 

It’s  common  to  publish  different  groups  of  data  to  different  multicast  groups.  According 
to  RFC  3171, 27  addresses  224.0.0.0  to  239.255.255.255  are  designated  as  multicast  addresses. 
Different  multicast  address  regions  are  designated  for  different  purposes.  According  to  RFC 
23  65, 28  Chapter  10  data  streaming  should  be  directed  to  multicast  addresses  in  the  local  scope 
address  range  239.255.0.0  to  239.255.255.255. 

All  IP  multicast  packets  are  delivered  by  using  the  Ethernet  MAC  address  range 
01:00:5e:00:00:00  -  01:00:5e:7f:ff:ff.  This  is  23  bits  of  available  address  space.  The  lower  23 
bits  of  the  28-bit  multicast  IP  address  are  mapped  into  the  23  bits  of  available  Ethernet  address 
space.  This  means  that  there  is  ambiguity  in  delivering  packets.  If  two  hosts  on  the  same  subnet 
each  subscribe  to  a  different  multicast  group  whose  address  differs  only  in  the  first  5  bits, 
Ethernet  packets  for  both  multicast  groups  will  be  delivered  to  both  hosts,  requiring  the  network 
software  in  the  hosts  to  discard  the  unrequired  packets.  If  multiple  multicast  addresses  are  used, 
be  careful  to  choose  multicast  addresses  that  will  result  in  different  Ethernet  multicast  addresses. 

Multicast  data  is  filtered  by  the  Ethernet  controller  hardware,  only  passing  subscribed 
packets  to  the  software  driver  for  decoding.  This  improves  performance  under  high  network 
traffic  loads.  Ethernet  controllers  only  have  a  limited  number  of  multicast  addresses  they  can 
filter.  A  common  hardware  unit  is  16  multicast  addresses.  If  a  workstation  needs  to  subscribe  to 


27  Internet  Engineering  Task  Force.  “IANA  Guidelines  for  IPv4  Multicast  Address  Assignments.”  RFC  3171. 
August  2001.  Obsoleted  by  RFC  5771.  Retrieved  4  August  2016.  Available  at 
https://datatracker.ietf.org/doc/rfc3171/. 

28  Internet  Engineering  Task  Force.  “Administratively  Scoped  IP  Multicast.”  RFC  2365.  July  1998.  Maybe 
superseded  by  update.  Retrieved  4  August  2016.  Available  at  https://datatracker.ietf.org/doc/rfc2365/. 
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more  multicast  addresses  than  the  Ethernet  hardware  provides  for,  then  all  multicast  traffic  is 
passed  to  the  software  driver  for  filtering,  negating  the  benefit  of  multicast  filtering  in  hardware. 

The  size  of  a  UDP  packet  is  represented  by  a  16-bit  value  in  the  IPv4  IP  and  UDP 
headers,  but  some  software  implementations  treat  this  as  a  signed  value  with  a  maximum  value 
of  2A 1 5  or  32,768.  Because  of  this,  the  maximum  size  of  a  Chapter  10  streaming  packet  should 
be  no  more  than  32,724  bytes.  Physical  networks  have  a  maximum  transfer  unit  (MTU),  which 
is  the  largest  data  packet  they  can  carry.  If  a  UDP  packet  has  a  size  larger  than  the  network 
MTU,  it  will  be  fragmented  into  smaller  packets  by  the  IP  software  driver  before  sending  them 
over  the  underlying  physical  network.  The  fragmented  UDP  packets  are  then  reassembled  into  a 
larger  packet  by  the  IP  software  driver  at  the  receiving  end.  There  is  a  performance  penalty  for 
this  fragmentation  and  reassembly.  Better  perfonnance  may  be  achieved  by  choosing  a  UDP 
packet  small  enough  to  avoid  fragmentation  and  reassembly.  Regular  Ethernet  supports  a 
maximum  size  of  1500  bytes  of  data  payload  (IP  header,  UDP  header,  and  UDP  data)  but  some 
newer  Ethernet  technologies  support  larger  jumbo  frames. 

Chapter  10  data  packets  are  sent  in  a  UDP/IP  packet  by  prepending  a  UDP  transfer 
header  to  the  UDP  data  payload.  Chapter  10  data  packet(s)  smaller  than  the  32-kb  maximum 
size  will  prepend  the  non-segmented  UDP  transfer  header  shown  in  Figure  5-65.  A  Chapter  10 
data  packet  larger  than  the  32-kb  maximum  size  will  need  to  be  segmented  before  transmission, 
and  will  prepend  the  segmented  UDP  transfer  header  shown  in  Figure  5-66.  The  IPv6  format 
supports  large  data  packets,  negating  the  need  for  segmented  data  packets. 


struct  SuUdpTransf erHeaderNonseg 
1 


uint32 

t 

uVersion 

:  4; 

//  Version 

uint32 

t 

uType 

:  4; 

//  Type  of  message 

uint32 

t 

uUdpSeqNum 

:  24; 

/ /  UDP  sequence  number 

U _ 

Figure  5-65.  UDP  Transfer  Header,  Non-Segmented  Data 


struct  SuUdpTransferHeaderSeg 
1 


uint32  t 

uVersion 

4; 

// 

Version 

uint32  t 

uType 

4; 

// 

Type  of 

message 

uint32  t 

uUdpSeqNum 

24; 

// 

UDP  sequence  number 

uint32  t 

uChanID 

16; 

// 

Channel 

ID 

uint32  t 

uChanSeqNum 

8; 

// 

Channel 

sequence  number 

uint32  t 
uint32  t 

uReserved 
uSegOf f set; 

8; 

// 

// 

Segment 

offset 

U _ 

Figure  5-66.  UDP  Transfer  Header,  Segmented  Data 

Computer-Generated  Data,  Format  3  (recording  index)  packets  are  meaningless  in  a 
network  data  stream.  It  is  necessary  that  they  be  transmitted  so  that  Channel  ID  0  data  packets 
will  have  contiguous  sequence  numbers  for  error  detection.  They  should  be  ignored,  though, 
when  received. 
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CHAPTER  6 

Conformance  to  IRIG  106 

The  Chapter  10  standard  sets  forth  requirements  for  digital  recorders.  The  IRIG  106 
Chapter  10.3.1  summarizes  requirements  for  a  recorder  to  be  considered  100  percent  compliant 
with  the  standard.  There  is  also  a  number  of  features  of  Chapter  10  that  are  considered  optional, 
which  are  not  required  to  be  implemented,  but  if  they  are  implemented  must  be  in  accordance 
with  the  Chapter  10  standard. 


Rather  than  reiterate  all  the  requirements  of  Chapter  10,  Table  6-1  and  Table  6-2  present 
a  brief  outline  of  the  major  requirement  areas  and  lists  those  portions  of  Chapter  10  that  have 
been  identified  as  optional. 


Table  6-1.  Physical  Interface  Requirements 

Ch  10  Section 

Required 

Optional 

10.3,  10.4.1 

1 

Recorder  Fibre  Channel 

10.4.2 

V 

Fibre  Channel  SCSI 

10.4.1 

S 

Data  Download 

10.3.11 

V 

Data  streaming 

10.3.8,  10.7 

S 

Configuration  with  TMATS 

10.7.1 

V 

Recorder  Control  and  Status 

10.4.2 

1 

Recorder  IEEE-1394B 

10.4.2.2 

V 

SCSFSBP-2 

10.4,  10.9 

V 

Data  Download 

10.3.11 

V 

Data  streaming 

10.3.8,  10.7 

S 

Configuration  with  TMATS 

10.7.1 

V 

Recorder  control  and  status 

10.4,  10.4.3 

1 

Recorder  Ethernet  (on  board) 

10.4 

V 

Data  Download 

10.3.11 

V 

Data  streaming 

10.3.8,  10.7 

S 

Configuration  with  TMATS 

10.7.1 

V 

Recorder  Control  And  Status 

10.3.5,  10.3.6 

s 

RMM 

10.9.5 

IEEE-1394B  Bilingual  Socket 

10.9 

V 

IEEE-1394B  SCSFSBP-2 

10.4,  10.9 

s 

Data  Download 

10.3.8,  10.7 

s 

Configuration  with  TMATS 

10.3.2,  10.7.10 

Discrete  Lines 

10.7.10 

V 

Recorder  control  and  status 

10.3.2 

V 

RS-232  and  422  Full  Duplex  Communication 

10.7 

s 

Configuration  with  TMATS 

10.7 

V 

Recorder  Control  And  Status 

10.3 

V 

External  Power  Port 
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1  -  Either  Fibre  Channel  or  IEEE  1394B  is  required  for  on-board  recorders;  other  network 
interfaces  are  optional.  Ethernet  is  required  for  ground-based  recorders;  other  network 
interfaces  are  optional. 


Table  6-2.  Logical  Interface  Requirements 

Logical  Interfaces 

Ch  10  Section 

Required 

Optional 

10.5 

V 

Media  File  Interface 

10.5 

Directory  &  File  Table  Entries 

10.3.7 

V 

STANAG  fields  - 

File  Size,  File  Create  Date,  File  Close  Time 

10.6 

Packetization  &  Data  Format 

10.6.1 

V 

Secondary  header 

10.6.1 

V 

Filler  for  packet  length 

10.6.1 

S 

Data  checksum 

10.6.1 

Intra-packet  headers  and  time  stamps 
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Appendix  A 

Selected  Source  Code  Files 


A  software  implementation  of  the  IRIG  106  Chapter  9  and  Chapter  10  standard  is 
available  from  www.irigl06.org  and  is  open  source,  meaning  it  is  freely  available  in  source  code 
form.  It  is  written  in  ANSI  C,  and  can  be  compiled  in  GNU  GCC  as  well  as  the  various 
Microsoft  Visual  Studio  compiler  suites.  Below  are  selected  source  files  demonstrating 
important  aspects  of  IRIG  106.  These  source  files  are  also  necessary  for  the  example  programs 
in  subsequent  appendices. 

This  code  is  under  active  development.  Go  to  www.irigl06.org  for  the  latest  version  of 
this  source  code  as  well  as  additional  source  code  files. 


Included  below  are  the  following  source  files. 


irigl06chl0.h 

irigl06chl0.c 

i  1 06  time.h 

i  1 06  time.c 

i  106  decode  time.h 

i  1 06  decode  time.c 

i  106  decode  tmats.h 

i  1 06  decode  tmats.c 

config.h 

stdint.h 


Structures,  macro  definitions,  and  procedures  for  opening,  reading/ 
writing,  and  moving  through  an  IRIG  106  data  file. 

Structures,  macro  definitions,  and  procedures  for  handling  time  in 
general 

Structures,  macro  definitions,  and  procedures  for  decoding  Time  Data 
packets 

Structures,  macro  definitions,  and  procedures  for  decoding  Computer- 
Generated  Data,  Format  1  (TMATS  setup  record)  packets. 

Structures  and  macro  definitions  to  provide  portability  across 
supported  compiler  suites. 

Macro  definitions  to  provide  standard  integer  types  of  specific  sizes 
across  supported  compiler  suites. 
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Appendix  A-l.  irigl06chl0.h 

/**************************************************************************** 
ir iglO 6chl 0 . h  - 

Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#ifndef  _irigl06chl0_h_ 

#define  _irigl06chl0_h_ 

#ifdef  _ cplusplus 

extern  "C"  { 

#endif 

#include  "config.h" 

/* 

*  Macros  and  definitions 

*  _ 

*/ 


#if  (defined (bTRUE) 

#def  ine  bTRUE  (1~‘.  ) 

#define  bFALSE  (1==0) 

#endif 

#def ine  MAX_HANDLES  4 

#def ine  IRIG106  SYNC  0xEB25 


//  Define  the  longest  file  path  string  size 
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#undef  MAX_PATH 

#def ine  MAX_PATH  260 

//  Header  and  secondary  header  sizes 
#def ine  HEADERJ3IZE  24 

#def ine  SEC_HEADER_SIZE  12 

//  Header  packet  flags 

#def ine  I106CH10_PFLAGS_CHKSUM_NONE  (uint8_t) 0x00 

#def ine  I106CH10_PFLAGS_CHKSUM_8  (uint8_t) 0x01 

#def ine  I106CH10_PFLAGS_CHKSUM_16  (uint8_t) 0x02 

#def ine  I106CH10_PFLAGS_CHKSUM_32  (uint8_t) 0x03 

#def ine  I106CH10_PFLAGS_OVERFLOW  (uint8_t) 0x10 

#def ine  I106CH10_PFLAGS_TIMESYNCERR  (uint8_t) 0x20 

#def ine  I106CH10_PFLAGS_SEC_HEADER  (uint8_t) 0x80 

//  Header  data  types 

#def ine  I106CH10_DTYPE_COMPUTER_0  (uint8_t) 0x00 

#def ine  I106CH10_DTYPE_USER_DEFINED  (uint8_t) 0x00 

#def ine  I106CH10_DTYPE_COMPUTER_1  (uint8_t) 0x01 

#def ine  I106CH10_DTYPE_TMATS  (uint8_t) 0x01 

#def ine  I106CH10_DTYPE_COMPUTER_2  (uint8_t) 0x02 

#def ine  I106CH10_DTYPE_RECORDING_EVENT  (uint8_t) 0x02 
#def ine  I106CH10_DTYPE_COMPUTER_3  (uint8_t) 0x03 

#def ine  I106CH10_DTYPE_RECORDING_INDEX  (uint8_t) 0x03 
#def ine  I106CH10_DTYPE_COMPUTER_4  (uint8_t) 0x04 

#def ine  I106CH10_DTYPE_COMPUTER_5  (uint8_t) 0x05 

#def ine  I106CH10_DTYPE_COMPUTER_6  (uint8_t) 0x06 

#def ine  I106CH10_DTYPE_COMPUTER_7  (uint8_t) 0x07 

#def ine  I106CH10_DTYPE_PCM_FMT_0  (uint8_t) 0x08 

#def ine  I106CH10_DTYPE_PCM_FMT_1  (uint8_t) 0x09 

#define  I106CH10_DTYPE_PCM  (uint8_t) 0x09  //  Deprecated 

#def ine  I106CH10^DTYPE^IRIG_TIME  (uint8_t) 0x11 

#def ine  I106CH10_DTYPE_1553_FMT_1  (uint8_t) 0x1 9 

#def ine  I106CH10_DTYPE_1553_FMT_2  (uint8_t) OxlA  //  16PP194  Bus 

#def ine  I106CH10_DTYPE_ANALOG  (uint8_t) 0x21 

#def ine  I106CH10_DTYPE_DISCRETE  (uint8_t) 0x2 9 

#def ine  I106CH10_DTYPE_MESSAGE  (uint8_t) 0x30 

#def ine  I106CH10_DTYPE_ARINC_429  (uint8_t) 0x38 

#def ine  I106CH10_DTYPE_VIDEO_FMT_0  (uint8_t) 0x40 

#def ine  I106CH10_DTYPE_VIDEO_FMT_1  (uint8_t) 0x41 

#def ine  I106CH10_DTYPE_VIDEO_FMT_2  (uint8_t) 0x42 

#def ine  I106CH10_DTYPE_IMAGE_FMT_0  (uint8_t) 0x48 

#def ine  I106CH10_DTYPE_IMAGE_FMT_1  (uint8_t) 0x4 9 

#def ine  I106CH10_DTYPE_UART_FMT_0  (uint8_t) 0x50 

#def ine  I106CH10_DTYPE_1394_FMT_0  (uint8_t) 0x58 

#def ine  I106CH10_DTYPE_1394_FMT_1  (uint8_t) 0x59 

#def ine  1 1 0 6CH1 0_DTYPE_PARALLEL_FMT_0  (uint8_t) 0x60 

#def ine  1 1 0 6CH1 0_DTYPE_ETHERNET_FMT_0  (uint8_t) 0x68 


III  Error  return  codes 
typedef  enum 
{ 

I106_OK 

110  6_OPEN_ERROR 

110  6_OPEN_WARNING 

I106_EOF 

I106_BOF 

110  6_READ_ERROR 

110  6_WRI TE_ERROR 

110  6_MORE_DATA 

I106_SEEK_ERROR 

1106  WRONG  FILE  MODE 


0,  ///<  Everything  okey  do key 

1,  ///<  Fatal  problem  opening  for  read  or  write 

2,  ///<  Non-fatal  problem  opening  for  read  or  write 

3,  ///<  End  of  file  encountered 

4,  // 

5,  ///<  Error  reading  data  from  file 

6,  ///<  Error  writing  data  to  file 

7,  // 

8, 

9, 
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1106  NOT  OPEN 

=  10, 

1106  ALREADY  OPEN 

=  11, 

1106  BUFFER  TOO  SMALL 

=  12, 

1106  NO  MORE  DATA 

=  13, 

1106  NO  FREE  HANDLES 

=  14, 

1106  INVALID  HANDLE 

=  15, 

1106  TIME  NOT  FOUND 

=  16, 

1106  HEADER  CHKSUM  BAD 

=  17, 

1106  NO  INDEX 

=  18, 

1106  UNSUPPORTED 
}  EnI106Status; 

=  19, 

III  Data  file  open  mode 
typedef  enum 
{ 

110  6_READ 

1 1 0 6  JDVERWRI TE 

I106_APPEND 

110  6_READ_IN_ORDER 

}  EnI106Chl0Mode; 


1,  //  Open  existing  file  for  reading 

2,  //  Create  new  file  or  overwrite  an  exising  file 

3,  //  Append  data  to  the  end  of  an  existing  file 

4,  //  Open  existing  file  for  reading  in  time  order 


III  Read  state  is  used  to  keep  track  of  the  next  expected  data  file  structure 


typedef  enum 

{ 

enclosed  =  0, 
enWrite  =  1, 
enReadUnsynced  =  2, 
enReadHeader  =  3, 
enReadData  =  4, 
}  EnFileState; 


III  Index  sort  state 
typedef  enum 
{ 

enUnsorted  =  0, 
enSorted  =  1, 
enSortError  =  2, 
}  EnSortStatus ; 


/* 

*  Data  structures 

~k _ 

*/ 

#if  defined (_MSC_VER) 

#pragma  pack (push) 

#pragma  pack(l) 

#endif 

III  IRIG  106  header  and  optional  secondary  header  data  structure 
typedef  PUBLIC  struct  SuI106Chl0Header_S 
{ 


uintl6  t 

uSync; 

///<  Packet  Sync  Pattern 

uintl6  t 

uChID; 

///<  Channel  ID 

uint32  t 

ulPacketLen; 

///<  Total  packet  length 

uint32  t 

ulDataLen; 

///<  Data  length 

uint8  t 

ubyHdrVer ; 

///<  Header  Version 

uint8  t 

ubySeqNum; 

///<  Sequence  Number 

uint8  t 

ubyPacketFlags ; 

///<  PacketFlags 

uint8  t 

ubyDataType; 

///<  Data  type 

uint8  t 

aubyRefTime [ 6] ; 

///<  Reference  time 

uintl6  t 

uChecksum; 

///<  Header  Checksum 
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#if 


uint32_t 
uintl6_t 
uintl6_t 
! defined ( 


aulTime [2] ; 
uReserved; 
uSecChecksum; 
GNUC  ) 


}  SuI106Chl0Header ; 


#else 


///<  Time  (start  secondary  header) 

// 

///<  Secondary  Header  Checksum 


}  _ attribute _  ( (packed) )  SuI106Chl0Header ; 

#endif 


//  Structure  for  holding  file  index 
typedef  struct 
{ 

int64_t  llOffset; 

int64_t  UTime; 

}  SuFilelndex; 


//  Various  file  index  array  indexes 
typedef  struct 
{ 


EnSortStatus 

SuFilelndex 

int 

int 

int 

int64  t 


int 

}  Sulndex; 


enSortStatus ; 

*  asulndex; 
iArraySize; 
iArrayUsed; 

iArrayCurr;  //  Current  position  in  index  array 
UNextReadOf  f  set  ; 
iNumSear chSteps ; 


III  Data  structure 
typedef  struct 
{ 

int 

int 

char 

EnI106Chl0Mode 
EnFileState 
Sulndex 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
char 


for  IRIG  106  read/write 


blnUse; 

iFile; 

szFileName [MAX_PATH] ; 
enFileMode ; 
enFileState; 
sulndex; 

ulCurrPacketLen; 
ulCurrHeaderBuffLen; 
ulCurrDataBuffLen; 
ulCurrDataBuf f ReadPos ; 
ulTotalBytesWr it ten; 
achReserve [128 ] ; 


}  SuI106Chl0Handle; 


handle 


#if  defined (_MSC_VER) 
#pragma  pack (pop) 
#endif 


/* 

*  Global  data 


*/ 


extern  SuI106Chl0Handle  g_sul 10 6Handle [ 4 ] ; 


/* 

*  Function  Declaration 
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~k 

*/ 


//  Open  /  Close 

DECL 

(int 

const  char 
EnI106Chl0Mode 

EnI106Status  I106_CALL_DECL 

enI106Chl0Close  (int 


EnI106Status  I106_CALL 
enI106ChlOOpen 


*  piI106Chl0Handle, 
szOpenFileName [ ] , 
enMode) ; 


iI106Handle) ; 


//  Read  /  Write 
// - 


EnI106Status  I106_CALL_DECL 

enI106Chl0ReadNextHeader (int 

SuI106Chl OHeader 


il 10  6Chl OHandle, 
psuI106Hdr) ; 


EnI106Status  I106_CALL_DECL 

enI106Chl0ReadNextHeaderFile (int  iHandle, 

SuI106Chl0Header  *  psuHeader) ; 


EnI106Status  I106_CALL_DECL 

enI106ChlOReadNextHeaderInOrder (int  iHandle, 

SuI106Chl0Header  *  psuHeader) ; 


EnI106Status  I106_CALL_DECL 

enI106Chl0ReadPrevHeader (int  iI106Chl0Handle, 

SuI106Chl0Header  *  psuI106Hdr) ; 


EnI106Status  I106_CALL_DECL 
enI106Chl0ReadData (int 

unsigned  long 
void 


iI106Chl OHandle, 
ulBuf f Size, 

*  pvBuff) ; 


EnI106Status  I106_CALL_DECL 
enI106Chl0WriteMsg (int 

SuI106Chl OHeader 
void 


iI106Chl OHandle, 

*  psuI106Hdr, 

*  pvBuff) ; 


//  Move  file  pointer 


EnI106Status  I106_CALL_DECL 

enI106Chl0FirstMsg (int  iI106Chl0Handle)  ; 

EnI106Status  I106_CALL_DECL 

enll 06Chl0LastMsg ( int  iI106Chl0Handle) ; 

EnI106Status  I106_CALL_DECL 

enI106Chl0SetPos (int  iI106Chl0Handle,  int64_t  llOffset) ; 
EnI106Status  I106_CALL_DECL 

enI106Chl0GetPos (int  iI106Chl0Handle,  int64_t  *  pllOffset) ; 
//  Utilities 


int  1106  CALL  DECL 
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iHeaderlnit (SuI106Chl0Header  * 
unsigned  int 
unsigned  int 
unsigned  int 
unsigned  int 


psuHeader , 
uChanID, 
uDataType, 
uFlags, 
uSeqNum) ; 


int  I106_CALL_DECL 

iGetHeaderLen (SuI106Chl0Header  *  psuHeader); 


uint32_t  110  6_CALL_DECL 

uGetDataLen (SuI106Chl0Header  *  psuHeader); 


uintl 6_t  110  6_CALL_DECL 

uCalcHeaderChecksum (SuI106Chl0Header  *  psuHeader); 


uintl 6_t  I106_CALL_DECL 

uCalcSecHeaderChecksum (SuI106Chl0Header  *  psuHeader); 


uint32_t  I106_CALL_DECL 

uCalcDataBuf fReqSize (uint32_t  uDataLen,  int  iChecksumType) ; 

EnI106Status  I106_CALL_DECL 

uAddDataFillerChecksum (SuI106Chl0Header  *  psuI106Hdr, 

unsigned  char  achData [ ] ) ; 


//  In-order  indexing 
// - 

void  I106_CALL_DECL 

vMakelnOrder Index ( int  iHandle) ; 

int  110  6_CALL_DECL 

bReadlnOrder Index ( int  iHandle,  char  *  szIdxFileName) ; 
int  110  6_CALL_DECL 

bWritelnOrderlndex ( int  iHandle,  char  *  szIdxFileName); 

#ifdef  _ cplusplus 

} 

#endif 

#endif 
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Appendix  A-2 .  irig  1 06ch  1 0 .  c 

/**************************************************************************** 
irigl06chl0 . c  - 

Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <fcntl.h> 

#include  <sys/types . h> 

#include  <sys/stat.h> 

#if  defined (_WIN32 ) 

#include  <io.h> 

#endif 


#include  "config.h" 
#include  "stdint.h" 

#include  "irigl06chl0.h" 
#include  "il06_time.h" 

/* 

*  Macros  and  definitions 

*  _ 

*/ 
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/* 

*  Data  structures 


*/ 


/* 

struct  SuInOrderHdrlnf o 

{ 

SuI106Chl0Header 
struct  SuInOrderHdrlnf o 
struct  SuInOrderHdrlnf o 


suHdr ; 

*  psuNext; 

*  psuPrev; 


*/ 


/* 

*  Module  data 


*/ 


SuI106Chl0Handle  g_sull 06Handle [MAX_HANDLES ] ; 
static  int  m  bHandlesInited  =  bFALSE; 


//  In  order  read  linked 
/* 

struct  SuInOrderHdrlnf o 
struct  SuInOrderHdrlnf o 
struct  SuInOrderHdrlnf o 

struct  SuInOrderHdrlnf o 
*/ 

/* 

*  Function  Declaration 


*/ 


list  pointers 

*  m_psuFir stlnOrderHdr 

*  m_psuLastInOrderHdr 

*  m_psuCurrInOrderHdr 

*  m_psuFir stlnOrderFree 


NULL; 

NULL; 

NULL; 

NULL; 


#ifdef  LOOK-AHEAD 

void  vCheckFillLookAheadBuf f er (int  iHandle) ; 
#endif 


/* 


EnI106Status  1106  CALL  DECL 


enI106ChlOOpen (int 

const  char 
EnI106Chl0Mode 


{ 

int 

int 

int 

uintl6— t 

EnI106Status 

SuI106Chl0Header 


iReadCnt ; 
ildx; 
iFlags ; 
uSignature 
enStatus ; 
suI106Hdr; 


*  piHandle, 
szFileName [ ] , 
enMode) 


//  Initialize  handle  data  if  necessary 
if  (m_bHandlesInited  ==  bFALSE) 

{ 

for  (ildx=0;  i I dx<MAX_HANDLE  S ;  ildx+  +  ) 

g_suI106Handle [ildx] .blnUse  =  bFALSE; 
m_bHandlesInited  =  bTRUE; 

}  //  end  if  file  handles  not  inited  yet 


*/ 
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//  Get  the  next  available  handle 
*piHandle  =  -1; 

for  (ildx=0;  iIdx<MAX_HANDLES;  ildx++) 

{ 

if  (g_suI106Handle [ildx] .blnUse  ==  bFALSE) 

{ 

g_suI106Handle [ildx] .blnUse  =  bTRUE; 

*piHandle  =  ildx; 
break; 

}  //  end  if  unused  handle  found 
}  //  end  looking  for  unused  handle 

if  (*piHandle  ==  -1) 

{ 

return  I106_NO_FREE_HANDLES; 

}  //  end  if  handle  not  found 

//  Initialize  some  data 

g_suI106Handle [*piHandle] . enFileState  =  enclosed; 
g_suI106Handle [*piHandle] . sulndex. enSortStatus  =  enUnsorted; 

//  Get  a  copy  of  the  file  name 

strncpy  (g_sul 10 6Handle [ *piHandle] . szFileName,  szFileName, 
sizeof (g_suI106Handle [*piHandle] . szFileName) ) ; 
g_sull 06 Handle [ * pi Handle ]  . szFileName [sizeof (g_sul 10  6Handle [ *piHandle]  . szFileName) 

-  1] 

=  '  \  0  '  ; 

//  Reset  total  bytes  written 

g_suI106Handle [*piHandle] . ulTotalBytesWr itten  =  0L; 

/***  Read  Mode  ***/ 

//  Open  for  read 

if  ( (I106_READ  ==  enMode)  ||  (110  6_READ_IN_ORDER  ==  enMode) ) 

{ 

////  Try  to  open  file 
#if  defined (_MSC_VER) 

iFlags  =  0_RD0NLY  |  0_BINARY; 

#elif  defined ( _ GCC _ ) 

iFlags  =  0_RD0NLY  |  0_LARGEFILE; 

#else 

iFlags  =  0_RD0NLY; 

#endif 

g_suI106Handle [*piHandle] . iFile  =  open ( szFileName,  iFlags,  0) ; 
if  (g_suI106Handle [*piHandle] . iFile  ==  -1) 
return  I106_OPEN_ERROR; 

////  Check  to  make  sure  it  is  a  valid  IRIG  106  Ch  10  data  file 
//  Check  for  valid  signature 

//  If  we  couldn't  even  read  the  first  2  bytes  then  return  error 
iReadCnt  =  read (g_suI106Handle [*piHandle] . iFile,  SuSignature,  2); 
if  (iReadCnt  !=  2) 

{ 

close (g_suI106Handle [*piHandle] . iFile) ; 
return  Il06_OPEN_ERROR; 

} 

//  If  the  first  word  isn't  the  sync  value  then  return  error 
if  (uSignature  !=  IRIG106_SYNC) 
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{ 

close (g_suI106Handle [*piHandle] . iFile) ; 
return  I106_OPEN_ERROR; 

} 


////  Reading  data  file  looks  OK  so  check  some  other  stuff 

//  Open  OK  and  sync  character  OK  so  set  read  state  to  reflect  this 
g_suI106Handle [*piHandle] . enFileState  =  enReadHeader; 

//  Make  sure  first  packet  is  a  config  packet 
enI106Chl0SetPos (*piHandle,  0L) ; 

enStatus  =  enI106Chl0ReadNextHeaderFile (*piHandle,  &suI106Hdr) ; 
if  (enStatus  !=  I106JOK) 

return  I106_OPEN_WARNING; 

if  ( sull 06Hdr . ubyDataType  !=  I106CH10_DTYPE_COMPUTER_1) 
return  1106  OPEN  WARNING; 


//  Everything  OK  so  get  time  and  reset  back  to  the  beginning 
//  f seek (g_sull 06Handle [ *piHandle ] . pFile,  0L,  SEEK_SET) ; 

enI106Chl0SetPos (*piHandle,  0L)  ; 

g_suI106Handle [*piHandle] . enFileState  =  enReadHeader; 
g_suI106Handle [*piHandle] . enFileMode  =  enMode; 

if  (110  6_READ_IN_ORDER  ==  enMode) 

g_suI106Handle [*piHandle] . sulndex. iArrayCurr  =  0; 

}  //  end  if  read  mode 


/***  Overwrite  Mode  ***/ 

//  Open  for  overwrite 

else  if  (I106JOVERWRITE  ==  enMode) 

{ 

III  Try  to  open  file 
#if  defined (_MSC_VER) 

iFlags  =  0_WRONLY  |  0_CREAT  |  0_BINARY; 

#elif  defined ( _ GCC _ ) 

iFlags  =  0_WRONLY  |  0_CREAT  |  0_LARGEFILE; 

#else 

iFlags  =  0_WRONLY  |  0_CREAT; 

#endif 

g_suI106Handle [*piHandle] . iFile  =  open ( szFileName,  iFlags,  _S_IREAD  | 
_S_IWRITeY; 

if  (g_suI106Handle [*piHandle] . iFile  ==  -1) 
return  I106_OPEN_ERROR; 

//  Open  OK  and  write  state  to  reflect  this 
g_suI106Handle [*piHandle] . enFileState  =  enWrite; 
g_suI106Handle [*piHandle] . enFileMode  =  enMode; 

}  //  end  if  read  mode 


/***  Any  other  mode  is  an  error  ***/ 
else 

{ 

return  I106jOPEN_ERROR; 

} 
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return  I106_OK; 

} 


/* 


*/ 


EnI106Status  I106_CALL_DECL 

enI106Chl0Close (int  iHandle) 

{ 

//  If  handles  have  been  init'ed  then  bail 
if  (m_bHandlesInited  ==  bFALSE) 
return  I106_NOT_OPEN; 

//  Check  for  a  valid  handle 
if  ( (iHandle  <  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE)) 

{ 

return  110  6_INVALI D_HANDLE ; 

} 

//  Make  sure  the  file  is  really  open 
if  ( (g_suI106Handle [iHandle] . iFile  !=  -1)  && 
(g_suI106Handle [iHandle] .blnUse  ==  bTRUE) ) 
{ 

//  Close  the  file 

close (g_suI106Handle [iHandle] .iFile) ; 

} 


NULL; 

0; 

0; 

0; 

enUnsorted; 

//  Reset  some  status  variables 
g_suI106Handle [iHandle] . iFile  =  -1; 

g_sull 06Handle [ iHandle ]. blnUse  =  bFALSE; 

g_suI106Handle [iHandle] . enFileState  =  enclosed; 

return  I106_OK; 

} 


//  Free  index  buffer  and  mark  unsorted 
free (g_sul 10  6Handle [ iHandle]  . sulndex . a su Index) ; 
g_suI106Handle [iHandle] . sulndex . asulndex  = 

g_suI106Handle [iHandle] . sulndex. iArraySize  = 

g_suI106Handle [iHandle] . sulndex. iArrayUsed  = 

g_sull 06Handle [ iHandle ] . sulndex . iNumSearchSteps  = 
g_suI106Handle [iHandle] . sulndex . enSortStatus  = 


/*  -  */ 

//  Get  the  next  header.  Depending  on  how  the  file  was  opened  for  reading, 

//  call  the  appropriate  routine. 

EnI106Status  I106_CALL_DECL 

enI106Chl0ReadNextHeader (int  iHandle, 

SuI106Chl0Header  *  psuHeader) 

{ 

EnI106Status  enStatus; 

switch  (g_suI106Handle [iHandle] .enFileMode) 

{ 

case  1106  READ  ; 
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enStatus  =  enI106Chl0ReadNextHeaderFile (iHandle,  psuHeader); 
break; 

case  I106_READ_IN_ORDER  : 

if  (g_suI106Handle [iHandle] . sulndex . enSortStatus  ==  enSorted) 

enStatus  =  enI106ChlOReadNextHeaderInOrder (iHandle,  psuHeader) 

else 

enStatus  =  enI106Chl0ReadNextHeaderFile (iHandle,  psuHeader); 
break; 

default  : 

enStatus  =  I106_WRONG_FILE_MODE; 
break; 

}  //  end  switch  on  read  mode 

return  enStatus; 

} 


/*  -  */ 

//  Get  the  next  header  in  the  file  from  the  current  position 
EnI106Status  I106_CALL_DECL 

enI106Chl0ReadNextHeaderFile (int  iHandle, 

SuI106Chl0Header  *  psuHeader) 

{ 


int 

iReadCnt ; 

int 

bReadHeaderWasOK 

int64  t 

USkipSize; 

int64  t 

XlFileOf fset; 

EnI106Status 

enStatus ; 

//  Check  for 

a  valid  handle 

if  ( (iHandle 

<  0)  II 

(iHandle  >  MAX_HANDLES)  |  | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE) ) 

{ 

return  110  6_INVALI D_HANDLE ; 

} 

//  Check  file  state 

switch  (g_suI106Handle [iHandle] . enFileState) 

{ 

case  enclosed  : 

return  I106_NOT_OPEN; 
break; 

case  enWrite  : 

return  I106_WRONG_FILE_MODE; 
break; 

case  enReadHeader  : 
break; 

case  enReadData  : 

USkipSize  =  g_suI106Handle [iHandle] . ulCurrPacketLen  - 

g_suI106Handle [iHandle] . ulCurrHeaderBuf fLen  - 
g_suI106Handle [ iHandle] . ulCurrDataBuf f ReadPos ; 
enStatus  =  enI106Chl0GetPos (iHandle,  sllFileOff set) ; 
if  (enStatus  !=  I106_OK) 

return  1106  SEEK  ERROR; 
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HFileOffset  +=  USkipSize; 

enStatus  =  enI106Chl0SetPos (iHandle,  HFileOf f set)  ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

break; 

case  enReadUnsynced  : 
break; 

}  //  end  switch  on  file  state 

//  Now  we  might  be  at  the  beginning  of  a  header.  Read  what  we  think 
//  is  a  header,  check  it,  and  keep  reading  if  things  don't  look  correct. 
bReadHeaderWasOK  =  bTRUE; 
while  (bTRUE) 

{ 


//  Read  the  header 

iReadCnt  =  read (g_suI106Handle [iHandle] . iFile,  psuHeader,  HEADER_SIZE) 

//  Keep  track  of  how  much  header  we've  read 

g_sull 06Handle [ iHandle ]. ulCurrHeaderBuf fLen  =  HEADER_SIZE; 

//  If  there  was  an  error  reading,  figure  out  why 
if  (iReadCnt  !=  HEADERJ3IZE) 

{ 

g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 
if  (iReadCnt  ==  -1) 

return  110  6_READ_ERROR ; 

else 

return  I106_EOF; 

}  //  end  if  read  error 

//  Setup  a  one  time  loop  to  make  it  easy  to  break  out  if 
//  there  is  an  error  encountered 
do 

{ 

//  Read  OK,  check  the  sync  field 
if  (psuHeader->uSync  !=  IRIG106_SYNC) 

{ 

g_sull 06Handle [ iHandle ]. enFileState  =  enReadUnsynced; 

bReadHeaderWasOK  =  b FALSE; 

break; 

} 

//  Always  check  the  header  checksum 

if  (psuHeader->uChecksum  !=  uCalcHeaderChecksum (psuHeader ) ) 

{ 

//  If  the  header  checksum  was  bad  then  set  to  unsynced  state 
//  and  return  the  error.  Next  time  we're  called  we'll  go 
//  through  lots  of  heroics  to  find  the  next  header, 
if  (g_suI106Handle [iHandle] . enFileState  !=  enReadUnsynced) 

{ 

g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 
return  110  6_HEADER_CHKSUM_BAD ; 

} 

bReadHeaderWasOK  =  b FALSE; 
break; 

} 
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//  MIGHT  NEED  TO  CHECK  HEADER  VERSION  HERE 

//  Header  seems  OK  at  this  point 

//  Figure  out  if  there  is  a  secondary  header 

if  ( (psuHeader->ubyPacketFlags  &  I106CH10_PFLAGS_SEC_HEADER)  !=  0) 

{ 

//  Read  the  secondary  header 

iReadCnt  =  read (g_sull 06Handle [ iHandle] . iFile, 

&psuHeader->aulTime [ 0 ]  ,  SEC_HEADER_SIZE) ; 

//  Keep  track  of  how  much  header  we've  read 

g_suI106Handle [iHandle] . ulCurrHeaderBuf fLen  +=  SEC_HEADER_SIZE; 

//  If  there  was  an  error  reading,  figure  out  why 
if  (iReadCnt  !=  HEADERJ3IZE) 

{ 

g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 
if  (iReadCnt  ==  -1) 

return  110  6_READ_ERROR; 

else 

return  I106_EOF; 

}  //  end  if  read  error 

//  Always  check  the  secondary  header  checksum  now 
if  (psuHeader->uChecksum  !=  uCalcSecHeaderChecksum (psuHeader ) ) 

{ 

//  If  the  header  checksum  was  bad  then  set  to  unsynced  state 
//  and  return  the  error.  Next  time  we're  called  we'll  go 
//  through  lots  of  heroics  to  find  the  next  header, 
if  (g_sull 06Handle [iHandle] . enFileState  !=  enReadUnsynced) 

{ 

g_sull 06Handle [iHandle] . enFileState  =  enReadUnsynced; 
return  110  6_HEADER_CHKSUM_BAD ; 

} 

bReadHeaderWasOK  =  b FALSE; 
break; 

} 


}  //  end  if  secondary  header 

}  while  (bFALSE) ;  //  end  one  time  error  testing  loop 

//  If  read  header  was  OK  then  break  out 
if  (bReadHeaderWasOK  ==  bTRUE) 
break; 

//  Read  header  was  not  OK  so  try  again  4  bytes  beyond  previous  read  point 
enStatus  =  enI106Chl0GetPos (iHandle,  sllFileOff set)  ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

HFileOffset  =  HFileOffset  -  g_suI106Handle [iHandle] . ulCurrHeaderBuf fLen  +  1; 

enStatus  =  enI106Chl0SetPos (iHandle,  HFileOf fset) ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

}  //  end  while  looping  forever,  looking  for  a  good  header 
//  Save  some  data  for  later  use 

g_sull 06Handle [ iHandle ] . ulCurrPacketLen  =  psuHeader->ulPacketLen; 

g_sull 06Handle [ iHandle ] . ulCurrDataBuf fLen  =  uGetDataLen(psuHeader); 

g_sull 06Handle [ iHandle ]. ulCurrDataBuf f ReadPos  =  0; 
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g_suI106Handle [iHandle] . enFileState  =  enReadData; 

return  I106_OK; 

}  //  end  enll06Chl0ReadNextHeaderFile ( ) 


/*  -  */ 

//  Get  the  next  header  in  time  order  from  the  file 


EnI106Status  I106_CALL_DECL 

enll 0 6 ChlOReadNext Header InOrder ( int 

SuI106Chl0Header 


{ 


iHandle, 

*  psuHeader) 


Sulndex 

EnI106Status 

int64_t 

EnFileState 


*  psulndex  =  &g_sull 06Handle [ iHandle] . sulndex; 
enStatus ; 
llOf fset; 
enSavedFileState; 


//  If  we're  at  the  end  of  the  list  then  we  are  at  the  end  of  the  file 
if  (psuIndex->iArrayCurr  ==  psuIndex->iArrayUsed) 
return  I106_EOF; 

//  Save  the  read  state  going  in 

enSavedFileState  =  g_suI106Handle [iHandle] . enFileState; 

//  Move  file  pointer  to  the  proper,  er,  point 

llOffset  =  psulndex->asulndex [psuIndex->iArrayCurr ]. llOffset; 

enStatus  =  enI106Chl0SetPos (iHandle,  llOffset); 

//  Go  ahead  and  get  the  next  header 

enStatus  =  enI106Chl0ReadNextHeaderFile (iHandle,  psuHeader); 

//  If  the  state  was  unsynced  before  but  is  synced  now,  figure  out  where  in  the 
//  index  we  are 

if  ( (enSavedFileState  ==  enReadUnsynced)  && 

(g_sul 10 6Handle [ iHandle] . enFileState  !=  enReadUnsynced)) 

{ 

enI106Chl0GetPos (iHandle,  SllOffset) ; 
llOffset  -=  iGetHeaderLen (psuHeader ) ; 
psuIndex->iArrayCurr  =  0; 

while  (psuIndex->iArrayCurr  <  psuIndex->iArrayUsed) 

{ 

if  (llOffset  ==  psulndex->asulndex [psuIndex->iArrayCurr ]. llOffset) 
break; 

psuIndex->iArrayCurr++ ; 

} 

//  if  psuIndex->iArrayCurr  ==  psuIndex->iArrayUsed  then  bad  things  happened 

} 


//  Move  array  index  to  the  next  element 
psuIndex->iArrayCurr++ ; 

return  enStatus; 

}  //  end  enl 10 6Chl OReadNextHeaderlnOrder ( ) 


/* 


*/ 


EnI106Status  1106  CALL  DECL 


A-16 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


enI106Chl0ReadPrevHeader (int  iHandle, 

SuI106Chl0Header  *  psuHeader) 

{ 


int 

bFound; 

int 

iReadCnt ; 

int64  t 

USkipSize 

int64  t 

HCurrPos  ; 

EnI106Status 

enStatus ; 

//  Check  for 

a  valid  handle 

if  ( (iHandle 

<  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE) ) 

{ 

return  I106_INVALID_HANDLE; 

} 

//  Check  file  mode 

switch  (g_suI106Handle [iHandle] . enFileState) 

{ 

case  enclosed  : 

return  1 1 0 6_NOT JOPEN ; 
break; 

case  enWrite  : 

return  I106_WRONG_FILE_MODE; 
break; 

case  enReadHeader  ; 
case  enReadData  : 

//  Backup  to  a  point  just  before  the  most  recently  read  header. 

//  The  amount  to  backup  is  the  size  of  the  previous  header  and  the  amount 
//  of  data  already  read. 

USkipSize  =  g_suI106Handle [iHandle] . ulCurrHeaderBuf f Len  + 
g_suI106Handle [iHandle] . ulCurrDataBuf f ReadPos ; 

//  Now  to  save  some  time  backup  more,  at  least  the  size  of  a  header  with 

no  data 

USkipSize  +=  HEADERJ3IZE; 
break; 

case  enReadUnsynced  : 

USkipSize  =  4; 

break; 

}  //  end  switch  file  state 


//  Figure  out  where  we're  at  and  where  in  the  file  we  want  to  be  next 
enI106Chl0GetPos (iHandle,  SllCurrPos)  ; 

//  If  unsynced  then  make  sure  we  are  on  a  4  byte  offset 
if  (g_sull 06Handle [ iHandle ]. enFileState  ==  enReadUnsynced) 

USkipSize  =  USkipSize  -  (HCurrPos  %  4); 

HCurrPos  -=  USkipSize; 

//  Now  loop  forever  looking  for  a  valid  packet  or  die  trying 
bFound  =  bFALSE; 
while  (bTRUE) 

{ 

//  Go  to  the  new  position  and  look  for  a  legal  header 
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enStatus  =  enI106Chl0SetPos (iHandle,  HCurrPos)  ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

//  Read  and  check  the  header  sync 

iReadCnt  =  read (g_suI106Handle [iHandle] . iFile,  & (psuHeader->uSync) ,  2) 
if  (iReadCnt  !=  2) 

return  I106_SEEK_ERROR; 
if  (psuHeader->uSync  !=  IRIG106_SYNC) 
continue ; 

//  Sync  pattern  matched  so  check  the  header  checksum 
iReadCnt  =  read (g__sull 06Handle [ iHandle] . iFile,  & (psuHeader->uChID) , 
HEADERJ3IZE-2) ; 

if  (iReadCnt  !=  HEADERJ3IZE-2) 
return  I106_SEEK_ERROR; 

if  (psuHeader->uChecksum  ==  uCalcHeaderChecksum (psuHeader ) ) 

{ 

bFound  =  bTRUE; 
break; 

} 

//No  match,  go  back  4  more  bytes  and  try  again 
HCurrPos  -=  4; 

//  Check  for  begining  of  file 
if  (HCurrPos  <  0) 

{ 

return  I106_BOF; 

} 


}  //  end  looping  forever 

//  If  good  header  found  then  go  back  to  just  before  the  header 
//  and  call  GetNextHeader ( )  to  let  it  do  all  the  heavy  lifting, 
if  (bFound  ==  bTRUE) 

{ 

enStatus  =  enI106Chl0SetPos (iHandle,  HCurrPos) ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

g__suI106Handle [iHandle] . enFileState  =  enReadHeader ; 
enStatus  =  enI106Chl0ReadNextHeader (iHandle,  psuHeader); 

} 


return  enStatus; 

}  //  end  enI106Chl0ReadPrevHeader ( ) 


/*  -  */ 

EnI106Status  I106_CALL_DECL 
enI106Chl0ReadData (int 

unsigned  long 
void 

{ 

int  iReadCnt; 

unsigned  long  ulReadAmount ; 

//  Check  for  a  valid  handle 
if  ( (iHandle  <  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE) ) 


iHandle, 
ulBuf fSize, 
*  pvBuff) 
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{ 

return  110  6_INVALI D_HANDLE ; 

} 


//  Check  file  state 

switch  (g_suI106Handle [iHandle] . enFileState) 

{ 

case  enclosed  : 

return  1 1 0  6_NOT  JOPEN  ; 
break; 

case  enWrite  : 

return  I106_WRONG_FILE_MODE; 
break; 

case  enReadData  : 
break; 

default  : 

//  MIGHT  WANT  TO  SUPPORT  THE  "MORE  DATA"  METHOD  INSTEAD 

g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 

return  110  6_READ_ERROR ; 

break; 

}  //  end  switch  file  state 

//  Make  sure  there  is  enough  room  in  the  user  buffer 
//  MIGHT  WANT  TO  SUPPORT  THE  "MORE  DATA"  METHOD  INSTEAD 

ulReadAmount  =  g_sul 10 6Handle [ iHandle] . ulCurrDataBuf f Len  - 

g_sul 10  6Handle [ iHandle]  . ulCurrDataBuf fReadPos ; 
if  (ulBuffSize  <  ulReadAmount) 

return  I106_BUFFER_TOO_SMALL; 

//  Read  the  data,  filler,  and  data  checksum 

iReadCnt  =  read (g_suI106Handle [iHandle] . iFile,  pvBuff,  ulReadAmount); 

//  If  there  was  an  error  reading,  figure  out  why 
if  ((unsigned  long) iReadCnt  !=  ulReadAmount) 

{ 

g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 
if  (iReadCnt  ==  -1) 

return  110  6_READ_ERROR ; 

else 

return  I106_EOF; 

}  //  end  if  read  error 

//  Keep  track  of  our  read  position  in  the  current  data  buffer 
g_suI106Handle [iHandle] . ulCurrDataBuf fReadPos  =  ulReadAmount; 

//  MAY  WANT  TO  DO  CHECKSUM  CHECKING  SOMEDAY 

//  Expect  a  header  next  read 

g__suI106Handle [iHandle] . enFileState  =  enReadHeader; 

return  I106_OK; 

}  //  end  enI106Chl0ReadData ( ) 


/*  - 

EnI106Status  I106_CALL_DECL 

enI106Chl0WriteMsg (int  iHandle, 

SuI106Chl0Header  *  psuHeader, 


*/ 
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void  *  pvBuff) 

{ 

int  iHeaderLen; 

int  iWriteCnt; 

//  Check  for  a  valid  handle 
if  ( (iHandle  <  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE) ) 

{ 

return  110  6_INVALI D_HANDLE ; 

} 

//  Figure  out  header  length 
iHeaderLen  =  iGetHeaderLen (psuHeader ) ; 

//  Write  the  header 

iWriteCnt  =  wr ite (g_sull 06Handle [ iHandle ]. iFile,  psuHeader,  iHeaderLen); 

//  If  there  was  an  error  reading,  figure  out  why 
if  (iWriteCnt  !=  iHeaderLen) 

{ 

return  I106_WRITE_ERROR; 

}  //  end  if  write  error 

//  Write  the  data 

iWriteCnt  =  wr ite (g_sull 06Handle [ iHandle ]. iFile,  pvBuff, 
psuHeader->ulPacketLen- iHeaderLen ) ; 

//  If  there  was  an  error  reading,  figure  out  why 

if  ((unsigned  long) iWriteCnt  !=  (psuHeader->ulPacketLen-iHeaderLen) ) 

{ 

return  I106_WRITE_ERROR; 

}  //  end  if  write  error 

return  I106_OK; 

} 


/*  - 

*  Move  file  pointer 

*  - *  i 

EnI106Status  I106_CALL_DECL 

enI106Chl0FirstMsg (int  iHandle) 

{ 

if  (g_sull 06Handle [ iHandle ]. enFileMode  ==  I106_READ_IN_ORDER) 
g_sull 06Handle [ iHandle ]. sulndex . iArrayCurr  =  0; 

enI106Chl0SetPos (iHandle,  0L) ; 
return  I106_OK; 

} 


/*  -  */ 

EnI106Status  I106_CALL_DECL 

enll 06Chl0LastMsg ( int  iHandle) 

{ 

EnI106Status  enReturnStatus ; 
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EnI106Status 

enStatus ; 

int64  t 

UPos  ; 

SuI106Chl0Header 

suHeader; 

int 

iReadCnt ; 

struct  stat 

suStatBuf f; 

//  If  its  opened 

for  reading  in  order  then  just  set 

the  index  pointer 

//  to  the  last  index. 

if  (g  suI106Handle [iHandle] . enFileMode  ==  1106  READ 

IN  ORDER) 

{ 

g_sull 06Handle [ iHandle ] . sulndex. iArrayCurr  = 


g_sull 06 Handle [iHandle ] .sulndex . iArrayUsed-1 ; 
enReturnStatus  =  I106_OK; 

} 

//  If  there  is  no  index  then  do  it  the  hard  way 
else 

{ 

//  enReturnStatus  =  I106_SEEK_ERROR; 

//  MAYBE  ALL  WE  NEED  TO  DO  TO  SEEK  TO  JUST  PAST  THE  END,  SET  UNSYNC ' ED  STATE, 

//  AND  THEN  CALL  enl 1 0 6Chl OPrevMsg ( ) 

//  Figure  out  how  big  the  file  is  and  go  to  the  end 
//  UPos  =  filelength (_fileno (g_sul 10 6Handle [iHandle ]. pFile) )  -  HEADER_SIZE; 

f stat (g_sull 06Handle [ iHandle ] .iFile,  SsuStatBuff) ; 

UPos  =  suStatBuf f . st_size  -  HEADER_SIZE; 

//if  (  (UPos  %  4)  !=  0) 

//  return  I10  6__SEEK_ERROR; 

//  Now  loop  forever  looking  for  a  valid  packet  or  die  trying 
while  (1==1) 

{ 

//  Not  at  the  beginning  so  go  back  1  byte  and  try  again 
UPos  -=  1; 

//  Go  to  the  new  position  and  look  for  a  legal  header 
enStatus  =  enI106Chl0SetPos (iHandle,  UPos) ; 
if  (enStatus  !=  I106_OK) 

return  I106_SEEK_ERROR; 

//  Read  and  check  the  header 

iReadCnt  =  read (g_suI106Handle [iHandle] . iFile,  SsuHeader,  HEADER_SIZE) 

if  (iReadCnt  !=  HEADERJ3IZE) 
continue ; 

if  (suHeader .uSync  !=  IRIG106J3YNC) 
continue ; 

//  Sync  pattern  matched  so  check  the  header  checksum 
if  ( suHeader . uChecksum  ==  uCalcHeaderChecksum (&suHeader ) ) 

{ 

enReturnStatus  =  I106_OK; 
break; 

} 

//  No  match,  check  for  begining  of  file 
if  (UPos  <=  0) 

{ 

enReturnStatus  =  1106  SEEK  ERROR; 
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break; 

} 


}  //  end  looping  forever 
}  //  end  if  not  read  in  order  mode 

//  Go  back  to  the  good  position 

enStatus  =  enI106Chl0SetPos (iHandle,  UPos)  ; 

return  enReturnStatus ; 

} 


/* 


*/ 


EnI106Status  I106_CALL_DECL 

enI106Chl0SetPos (int  iHandle,  int64_t  llOffset) 

{ 

//  Check  for  a  valid  handle 
if  ( (iHandle  <  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE) ) 

{ 

return  I106_INVALID_HANDLE; 

} 

//  Seek 

#if  defined (_MSC_VER) 

{ 

_ int64  UStatus; 

UStatus  =  _lseeki64 (g_suI106Handle [iHandle] . iFile,  llOffset,  SEEK_SET) ; 

} 

#else 

lseek (g_suI106Handle [iHandle] . iFile,  llOffset,  SEEK_SET)  ; 
fendif 

//  Can't  be  sure  we're  on  a  message  boundary  so  set  unsync ' ed 
g_suI106Handle [iHandle] . enFileState  =  enReadUnsynced; 

return  I106_OK; 

} 


/*  -  */ 

EnI106Status  I106_CALL_DECL 

enI106Chl0GetPos (int  iHandle,  int64_t  *pllOffset) 

{ 

//  Check  for  a  valid  handle 
if  ( (iHandle  <  0)  II 

(iHandle  >  MAX_HANDLES)  | | 

(g_suI106Handle [iHandle] .blnUse  ==  bFALSE)) 

{ 

return  110  6_INVALI D_HANDLE ; 

} 

//  Get  position 
#if  defined (_MSC_VER) 

*pllOffset  =  _telli64 (g_suI106Handle [iHandle] .iFile); 
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#else 

*pllOffset  =  lseek (g_sul 10 6Handle [ iHandle] . iFile,  0,  SEEK_CUR) ; 
fendif 

return  I106_OK; 

} 


/*  - 

*  Utilities 

-k  - *  I 

int  110  6_CALL_DECL 

iHeaderlnit (SuI106Chl0Header  *  psuHeader, 
unsigned  int  uChanID, 

unsigned  int  uDataType, 

unsigned  int  uFlags, 

unsigned  int  uSeqNum) 

{ 

//  Make  a  legal,  valid  header 
psuHeader->uSync  =  IRIG106J3YNC; 

psuHeader->uChID  =  uChanID; 

psuHeader->ulPacketLen  =  HEADER_SIZE; 

psuHeader->ulDataLen  =  0; 

psuHeader->ubyHdrVer  =  0x02; 

psuHeader->ubySeqNum  =  uSeqNum; 

psuHeader->ubyPacketFlags  =  uFlags; 

psuHeader->ubyDataType  =  uDataType; 

memset (& (psuHeader->aubyRefTime) ,  0,  6) ; 

psuHeader->uChecksum  =  uCalcHeaderChecksum (psuHeader ) ; 

memset (& (psuHeader->aulTime) ,  0,  8); 
psuHeader->uReserved  =  0; 

psuHeader->uSecChecksum  =  uCalcSecHeaderChecksum(psuHeader); 

return  0; 

} 

/*  -  */ 

//  Figure  out  header  length  (might  need  to  check  header  version  at 
//  some  point  if  I  can  ever  figure  out  what  the  different  header 
//  version  mean. 

int  I106_CALL_DECL 

iGetHeaderLen (SuI106Chl0Header  *  psuHeader) 

{ 

int  iHeaderLen; 

if  ( (psuHeader->ubyPacketFlags  &  I106CH10_PFLAGS_SEC_HEADER)  ==  0) 
iHeaderLen  =  HEADER_SIZE; 

else 

iHeaderLen  =  HEADER_SIZE  +  SEC_HEADER_S I ZE ; 

return  iHeaderLen; 

} 


/*  -  */ 
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//  Figure  out  data  length  including  padding  and  any  data  checksum 

uint32_t  I106_CALL_DECL 

uGetDataLen (SuI106Chl0Header  *  psuHeader) 

{ 

int  iDataLen; 

iDataLen  =  psuHeader->ulPacketLen  -  iGetHeaderLen (psuHeader ) ; 

return  iDataLen; 

} 


/* 


*/ 


uintl 6_t  110  6_CALL_DECL 

uCalcHeaderChecksum (SuI106Chl0Header  *  psuHeader) 

{ 

int  iHdrldx; 

uintl 6_t  uHdrSum; 

uintl6_t  *  aHdr  =  (uintl6_t  *)psuHeader; 

uHdrSum  =  0; 

for  ( iHdrIdx=0 ;  iHdr Idx< (HEADERJ3I ZE-2 ) /2 ;  iHdrIdx++) 
uHdrSum  +=  aHdr [ iHdr Idx] ; 

return  uHdrSum; 

} 


/*  -  */ 

uintl 6_t  110  6_CALL_DECL 

uCalcSecHeaderChecksum (SuI106Chl0Header  *  psuHeader) 

{ 

int  iByteldx; 

uintl 6_t  uHdrSum; 

//  MAKE  THis  16  BIT  UNSIGNEDS  LIKE  ABOVE 

unsigned  char  *  auchHdrByte  =  (unsigned  char  *) psuHeader; 

uHdrSum  =  0; 

for  ( iByteIdx=0 ;  iByteIdx<SEC_HEADER_SIZE-2 ;  iByteIdx++) 
uHdrSum  +=  auchHdrByte [iByteIdx+HEADER_SIZE] ; 

return  uHdrSum; 

} 


/*  -  */ 

//  Calculate  and  return  the  required  size  of  the  data  buffer  portion  of  the 
//  packet  including  checksum  and  appropriate  filler  for  4  byte  alignment. 

uint32_t  110  6_CALL_DECL 

uCalcDataBuf fReqSize (uint32_t  uDataLen,  int  iChecksumType) 

{ 

uint32_t  uDataBuf fLen; 

//  Start  with  the  length  of  the  data 
uDataBuffLen  =  uDataLen; 
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//  Add  in  enough  for  the  selected  checksum 
switch  ( iChecksumType) 

{ 

case  1 1 0 6CH1 0_PFLAGS_CHKSUM_NONE  : 
break; 

case  I106CH10_PFLAGS_CHKSUM_8  : 
uDataBuffLen  +=  1; 
break; 

case  1 1 0 6CH1 0_PFLAGS_CHKSUM_1 6  : 

uDataBuffLen  +=  2; 
break; 

case  110  6CH1 0_PFLAGS_CHKSUM_32  : 

uDataBuffLen  +=  4; 
break; 
default  : 

uDataBuffLen  =  0; 

}  //  end  switch  iChecksumType 

//  Now  add  filler  for  4  byte  alignment 
uDataBuffLen  +=  3; 
uDataBuffLen  &=  Oxfffffffc; 

return  uDataBuffLen; 

} 


/*  -  */ 

//  Add  the  filler  and  appropriate  checksum  to  the  end  of  the  data  buffer 
//  It  is  assumed  that  the  buffer  is  big  enough  to  hold  additional  filler 
//  and  the  checksum.  Also  fill  in  the  header  with  the  correct  packet  length. 

EnI106Status  I106_CALL_DECL 

uAddDataFillerChecksum (SuI106Chl0Header  *  psuI106Hdr,  unsigned  char  achDataf]) 

{ 

uint32_t  uDataldx; 

uint32_t  uDataBuf fSize; 

uint32_t  uFillSize; 

int  iChecksumType; 

uint8_t  *puSum8; 

uint8_t  *puData8; 

uintl6_t  *puSuml6; 
uintl6_t  *puDatal6; 
uint32_t  *puSum32; 
uint32_t  *puData32; 

//  Extract  the  checksum  type 

iChecksumType  =  psuI106Hdr->ubyPacketFlags  &  0x03; 

//  Figure  out  how  big  the  final  packet  will  be 

uDataBuf fSize  =  uCalcDataBuf fReqSize (psuI106Hdr->ulDataLen,  iChecksumType); 
psuI106Hdr->ulPacketLen  =  HEADER_SIZE  +  uDataBuffSize; 
if  ( (psuI106Hdr->ubyPacketFlags  &  I106CH10_PFLAGS_SEC_HEADER)  !=  0) 
psul 10  6Hdr->ulPacketLen  +=  SEC_HEADER_S I ZE ; 

//  Figure  out  the  filler/checksum  size  and  zero  fill  it 
uFillSize  =  uDataBuffSize  -  psuI106Hdr->ulDataLen; 
memset (SachData [psuI106Hdr->ulDataLen] ,  0,  uFillSize); 

//  If  no  checksum  then  we're  done 

if  (iChecksumType  ==  I106CH10_PFLAGS_CHKSUM_NONE) 
return  1106  OK; 
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//  Calculate  the  checksum 
switch  ( iChecksumType) 

{ 

case  I106CH10_PFLAGS_CHKSUM_8  : 

//  Checksum  the  data  and  filler 
puData8  =  (uint8_t  *)achData; 

puSum8  =  (uint8_t  * ) SachData [psull 06Hdr->ulDataLen+uFillSize-l ] ; 
for  (uDataIdx=0;  uDataldxkuDataBuff Size-1 ;  uDataIdx++) 

{ 

*puSum8  +=  *puData8; 
puData8++; 

} 

break; 

case  1 1 0 6CH1 0_PFLAGS_CHKSUM_1 6  : 

puDatal6  =  (uintl6_t  *)achData; 

puSuml6  =  (uintl6_t  * )  SachData [psull 06Hdr->ulDataLen+uFillSize-2 ] ; 
for  (uDataIdx=0;  uDataIdx< (uDataBuff Size/2 ) -1 ;  uDataIdx++) 

{ 

*puSuml6  +=  *puDatal6; 
puDatal6++; 

} 

break; 

case  110  6CH1 0_PFLAGS_CHKSUM_32  : 
puData32  =  (uint32_t  *)achData; 

puSum32  =  (uint32_t  * ) SachData [psull 06Hdr->ulDataLen+uFillSize-4 ] ; 
for  (uDataIdx=0;  uDataldxk (uDataBuff Size/ 4 ) -1 ;  uDataIdx++) 

{ 

*puSum32  +=  *puData32; 
puData32++; 

} 

break; 
default  : 
break; 

}  //  end  switch  iChecksumType 

return  I106_OK; 

} 


//  - 

//  Generate  an  index  from  the  data  file 
//  - 

/* 

Support  for  read  back  in  time  order  is  experimental.  Some  106-04  recorders 
recorder  data  *way*  out  of  time  order.  But  most  others  don't.  And  starting 
with  106-05  the  most  out  of  order  is  1  second. 

The  best  way  to  support  read  back  in  order  is  to  do  it  on  the  fly  as  the  file 
is  being  read.  But  that's  more  than  I'm  willing  to  do  right  now.  This  indexing 
scheme  does  get  the  job  done  for  now. 

*/ 

//  Read  the  index  from  a  previously  generated  index  file, 
int  110  6_CALL_DECL 

bReadlnOrder Index ( int  iHandle,  char  *  szIdxFileName) 

{ 

int  ildxFile; 
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int 

int 

int 

int 

Sulndex 


iFlags ; 

iArrayReadStart; 
iReadCnt ; 
bReadOK  =  bFALSE ; 

*  psulndex  =  &g_sull 06Handle [ iHandle] .sulndex; 


//  Setup  a  one  time  loop  to  make  it  easy  to  break  out  on  errors 
do 

{ 


//  Try  opening  and  reading  the  index  file 
#if  defined (_MSC_VER) 

iFlags  =  0_RD0NLY  |  0_BINARY; 

#else 

iFlags  =  0_RD0NLY; 

fendif 

ildxFile  =  open ( szIdxFileName,  iFlags,  0)  ; 
if  (ildxFile  ==  -1) 
break; 

//  Read  the  index  data  from  the  file 
while  (bTRUE) 

{ 

iArrayReadStart  =  psuIndex->iArraySize; 
psuIndex->iArraySize  t=  100; 

psulndex->asulndex  =  (SuFilelndex  *) realloc (psulndex->asulndex, 
sizeof  (SuFilelndex) *psuIndex->iArraySize) ; 
iReadCnt  =  read (ildxFile,  & (psulndex->asulndex [ iArrayReadStart] ) , 
100*sizeof (SuFilelndex) ) ; 

psuIndex->iArrayUsed  t=  iReadCnt  /  sizeof (SuFilelndex) ; 
if  (iReadCnt  !=  100*sizeof (SuFilelndex) ) 
break; 

}  //  end  while  reading  data  from  file 
close (ildxFile) ; 

//  MIGHT  WANT  TO  DO  SOME  SANITY  CHECKS  IN  HERE 

psuIndex->enSortStatus  =  enSorted; 
bReadOK  =  bTRUE; 

}  while  (bFALSE);  //  end  one  time  loop  to  read 


return  bReadOK; 

} 


//  - 

int  I106_CALL_DECL 

bWritelnOrderlndex ( int  iHandle,  char  *  szIdxFileName) 

{ 

int  iFlags; 

int  ildxFile; 

int  iWriteldx; 

Sulndex  *  psulndex  =  &g_suI106Handle [iHandle] . sulndex; 

//  Write  out  an  index  file  for  use  next  time 
#if  defined (_MSC_VER) 

iFlags  =  0_WR0NLY  |  0_CREAT  |  0_BINARY; 

#else 

iFlags  =  0_WR0NLY  |  0_CREAT ; 

#endif 
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ildxFile  =  open ( szIdxFileName,  iFlags,  _S_IREAD  |  _S_IWRITE) ; 
if  (ildxFile  !=  -1) 

{ 

//  Read  the  index  data  from  the  file 

for  ( iWr iteldx=0 ;  iWriteIdx<psuIndex->iArrayUsed;  iWriteIdx++) 

{ 

write (ildxFile,  & (psulndex->asulndex [iWriteldx] ) ,  sizeof (SuFilelndex) ) 
}  //  end  for  all  index  array  elements 

close (ildxFile) ; 

} 


return  b FALSE; 

} 


//  - 

//  This  is  used  in  qsort  in  vMakelnOrder Index ( )  below 

int  FileTimeCompare (const  void  *  psulndexl,  const  void  *  psulndex2) 

{ 

if  (((SuFilelndex  *) psulndexl ) ->llTime  <  ((SuFilelndex  *) psulndex2) ->llTime) 
return  -1; 

if  (((SuFilelndex  *) psulndexl ) ->llTime  >  ((SuFilelndex  *) psulndex2) ->llTime) 
return  1; 

return  0; 

} 


//  - 

//  Read  all  headers  and  make  an  index  based  on  time 


void  I106_CALL_DECL 

vMakelnOrder Index ( int  iHandle) 

{ 


EnI106Status 

int64_t 

int64_t 

SuI106Chl0Header 

int64_t 

Sulndex 


~k 


enStatus ; 
UStartPos  ; 
HCurrPos  ; 
suHdr ; 
HCurrTime  ; 
psulndex  = 


//  File  position  coming  in 
//  Current  file  position 
//  Data  packet  header 
//  Current  header  time 
&g_sull 06 Handle [ iHandle] . sulndex; 


//  Remember  the  current  file  position 

enStatus  =  enI106Chl0GetPos (iHandle,  SllStartPos)  ; 


enStatus  =  enI106Chl0SetPos (iHandle,  0L) ; 


//  Read  headers,  put  time  and  file  offset  into  index  array 
while  (bTRUE) 

{ 

enStatus  =  enI106Chl0ReadNextHeaderFile (iHandle,  SsuHdr) ; 


//  If  EOF  break  out 
if  (enStatus  ==  I106_EOF) 
break; 

//  If  an  error  then  clean  up  and  get  out 
if  (enStatus  !=  1106  OK) 
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{ 

free  (psulndex->asulndex)  ; 

psulndex->asulndex 

psuIndex->iArraySize 

psuIndex->iArrayUsed 

psuIndex->iNumSearchSteps 

psuIndex->enSort Status 

break; 

} 


NULL  ; 

0; 

0; 

0; 

enSortError ; 


//  Get  the  time  and  position 

enStatus  =  enI106Chl0GetPos  (iHandle,  StllCurrPos)  ; 
HCurrPos  -=  iGetHeaderLen (&suHdr) ; 
vTimeArray2LLLnt  ( suHdr  .  aubyRef Time ,  &HCurrTime)  ; 


//  Check  the  array  size,  make  it  bigger  if  necessary 
if  (psuIndex->iArrayUsed  >=  psuIndex->iArraySize) 

{ 

psuIndex->iArraySize  +=  100; 
psulndex->asulndex  = 

(SuFilelndex  *) realloc (psulndex->asulndex, 
sizeof  (SuFilelndex) *psuIndex->iArraySize)  ; 

} 


//  Copy  the  info  into  the  next  array  element 

psulndex->asulndex [psuIndex->iArrayUsed] . llOf f set  =  HCurrPos; 
psulndex->asulndex [psuIndex->iArrayUsed] . UTime  =  HCurrTime; 
psuIndex->iArrayUsed+t ; 

} 


//  Sort  the  index  array 

//  It  is  required  that  TMATS  is  the  first  record  and  IRIG  time  is  the 
//  second  record  so  don't  include  those  in  the  sort 
qsort ( & (psulndex->asulndex [2 ] ) ,  psuIndex->iArrayUsed-2 , 
sizeof (SuFilelndex)  ,  FileTimeCompare) ; 

//  Put  the  file  point  back  where  we  started  and  find  the  current  index 
//  THIS  SHOULD  REALLY  BE  DONE  FOR  THE  FILE-READ-OK  LOGIC  PATH  ALSO 
enStatus  =  enI106Chl0SetPos (iHandle,  UStartPos); 
psuIndex->iArrayCurr  =  0; 

while  (psuIndex->iArrayCurr  <  psuIndex->iArrayUsed) 

{ 

if  (UStartPos  ==  psulndex->asulndex [psuIndex->iArrayCurr ] . llOf fset) 
break; 

psuIndex->iArrayCurr++ ; 

} 

//  If  we  didn't  find  it  then  it's  an  error 
if  (psuIndex->iArrayCurr  ==  psuIndex->iArrayUsed) 

{ 

free  (psulndex->asulndex) ; 
psulndex->asulndex  =  NULL; 

psuIndex->iArraySize  =  0; 

psuIndex->iArrayUsed  =  0; 

psuIndex->iNumSearchSteps  =  0; 

psu!ndex->enSortStatus  =  enSortError; 


else 

psuIndex->enSortStatus  =  enSorted; 

return ; 

} 
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Appendix  A-3 .  i  1 06_time.h 

/**************************************************************************** 
il06_time.h  - 

Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#ifndef  _I106_TIME_H 
#def ine  _I106_TIME_H 

//  #include  "irigl06chl0 .h" 

#ifdef  _ cplusplus 

extern  "C"  { 

#endif 

/* 

*  Macros  and  definitions 

*  _ 

*/ 


typedef  enum 

{ 

110  6_DATEFMT_DAY  =  0, 
110  6_DATEFMT_DMY  =  1, 
}  EnI106DateFmt; 


/* 

*  Data  structures 
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//  Time  has  a  number  of  representations  in  the  IRIG  106  spec. 

//  The  structure  below  is  used  as  a  convenient  standard  way  of 
//  representing  time.  The  nice  thing  about  standards  is  that  there 
//  are  so  many  to  choose  from,  and  time  is  no  exception.  But  none  of 
//  the  various  C  time  representations  really  fill  the  bill.  So  I  made 
//  a  new  time  representation.  So  there, 
typedef  struct 
{ 

uint32_t  ulSecs;  //  This  is  a  time_t 

uint32_t  ulFrac;  //  LSB  =  100ns 

EnI106DateFmt  enFmt;  //  Day  or  DMY  format 

}  SuIrigl06Time; 


//  Relative  time  to  absolute  time  reference 
typedef  struct 
{ 

uint64_t  uRelTime;  //  Relative  time  from  header 

SuIrigl06Time  suIrigTime;  //  Clock  time  from  IRIG  source 

}  SuTimeRef; 


III  IRIG  106  secondary  header  time  in  Ch  4  BCD  format 
typedef  PUBLIC  struct  SuI106Ch4_BCD_Time_S 
{ 


uintl6  t 

uMinl 

4; 

//  High  order  time 

uintl6  t 

uMinlO 

3; 

uintl6  t 

uHourl 

4; 

uintl6  t 

uHourl 0 

2; 

uintl6  t 

uDayl 

3; 

uintl6  t 

uSecO  01 

4; 

//  Low  order  time 

uintl6  t 

uSecO  1 

4; 

uintl6  t 

uSecl 

4; 

uintl6  t 

uSeclO 

2; 

uintl6  t 

uReserved 

2; 

uintl6  t 

uUSecs ; 

//  Microsecond  time 

! defined ( 

GNUC _ ) 

}  SuI106Ch4 

BCD  Time; 

#else 

}  _ attribute _  ((packed))  SuI106Ch4_BCD_Time; 

fendif 


III  IRIG  106  secondary  header  time  in  Ch  4  binary  format 
typedef  PUBLIC  struct  SuI106Ch4_Binary_Time_S 
{ 

uintl6_t  uHighBinTime ;  //  High  order  time 

uintl6_t  uLowBinTime;  //  Low  order  time 

uintl6_t  uUSecs;  //  Microsecond  time 

#if  ! defined ( _ GNUC _ ) 

}  SuI106Ch4_Binary_Time; 

#else 

}  _ attribute _  ((packed))  SuI106Ch4_Binary_Time; 

fendif 


III  IRIG  106  secondary  header  time  in  IEEE-1588  format 
typedef  PUBLIC  struct  SuIEEE1588_Time_S 
{ 

uint32_t  uNanoSeconds ;  //  Nano-seconds 

uint32_t  uSeconds;  //  Seconds 

#if  ! defined ( _ GNUC  ) 
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}  SuIEEE1588_Time; 

#else 

}  _ attribute _  ( (packed) )  SuIEEE1588_Time; 

#endif 


III  Intra-packet  header  relative  time  counter  format 
typedef  PUBLIC  struct  SuIntraPacketRtc_S 
{ 

uint8_t  aubyRefTime [ 6 ] ;  //  Reference  time 

uintl6_t  uReserved; 

#if  ! defined ( _ GNUC _ ) 

}  SuIntraPacketRtc; 

#else 

}  _ attribute _  ((packed))  SuIntraPacketRtc; 

fendif 


/* 

*  Global  data 

*  _ 

*/ 

/* 

*  Function  Declaration 

~k _ 

*/ 

EnI106Status  I106_CALL_DECL 
enll 06_SetRelTime ( int 

SuIrigl06Time 
uint8_t 

EnI106Status  I106_CALL_DECL 
enI106_Rel2IrigTime (int 

uint8_t 
SuIrigl06Tii 

EnI106Status  I106_CALL_DECL 

enI106_Irig2RelTime (int  iI106Chl0Handle, 

SuIrigl06Time  *  psuTime, 
uint8_t  abyRelTime [ ] ) ; 

//  Warning  -  array  to  int  /  int  to  array  functions  are  little  endian  only! 

void  110  6_CALL_DECL 

vLLInt2TimeArray (int64_t  *  pllRelTime, 

uint8_t  abyRelTime []); 


void  110  6_CALL_DECL 

vTimeArray2LLInt (uint8_t  abyRelTime [ ] , 
int64_t  *  pllRelTime) ; 


EnI106Status  I106_CALL_DECL 

enI106_SyncTime (int  iI106Chl0Handle, 

int  bRequireSync,  //  Require  external  time  sync 

int  iTimeLimit) ;  //  Max  scan  ahead  time  in  seconds,  0  =  no 

limit 

EnI106Status  1106  CALL  DECL 


iI106Chl0Handle, 
*  psuTime, 

abyRelTime [ ] ) ; 


iI106Chl0Handle, 
abyRelTime [ ] , 

*  psuTime) ; 
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enI106Chl0SetPosToIrigTime (int  iI106Chl0Handle,  SuIrigl06Time  *  psuSeekTime ) 


//  General  purpose  time  utilities 
// - 

//  Convert  IRIG  time  into  an  appropriate  string 
char  *  IrigTime2String (SuIrigl06Time  *  psuTime) ; 

//  IT  WOULD  BE  NICE  TO  HAVE  SOME  FUNCTIONS  TO  COMPARE  6  BYTE 
//  TIME  ARRAY  VALUES  FOR  EQUALITY  AND  INEQUALITY 

//  This  is  handy  enough  that  we'll  go  ahead  and  export  it  to  the  world 
//  HMMM. . .  MAYBE  A  BETTER  WAY  TO  DO  THIS  IS  TO  MAKE  THE  TIME  VARIABLES 
//  AND  STRUCTURES  THOSE  DEFINED  IN  THIS  PACKAGE. 
time_t  110  6_CALL_DECL 

mkgmtime ( struct  tm  *  psuTmTime) ; 

#ifdef  _ cplusplus 

} 

fendif 

#endif 
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Appendix  A-4.  il06_time.c 

/**************************************************************************** 
il06_time.c  - 

Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 


*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 


#include 

#include 

#include 

#include 


<stdio . h> 
<stdlib . h> 
<string . h> 
<time . h> 


#include 

#include 

#include 

#include 


"stdint . h" 
"irigl06chl0.h" 

" il 06_time . h" 

"il06  decode  time.h" 


/* 

*  Macros  and  definitions 


*/ 


/* 

*  Data  structures 


*/ 


/* 

*  Module  data 
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*/ 

static  SuTimeRef  m_asuTimeRef [MAX_HANDLES ] ;  //  Relative  /  absolute  time  reference 
/* 

*  Function  Declaration 


*/ 


/*  -  */ 

//  Update  the  current  reference  time  value 
EnI106Status  I106_CALL_DECL 

enll 06_SetRelTime (int  ill 06Chl OHandle, 

SuIrigl06Time  *  psuTime, 
uint8_t  abyRelTime [ ] ) 

{ 

//  Save  the  absolute  time  value 

m_asuTimeRef [iI106Chl0Handle] . sulr igTime . ulSecs  =  psuTime->ulSecs ; 
m_asuTimeRef [iI106Chl0Handle] . sulr igTime . ulFrac  =  psuTime->ulFrac ; 
m_asuTimeRef [iI106Chl0Handle] . sulr igTime . enFmt  =  psuTime->enFmt; 

//  Save  the  relative  (i.e.,  the  10MHz  counter)  value 
m_asuTimeRef [iI106Chl0Handle] . uRelTime  =  0; 

memcpy ( ( char  * ) & (m_a suTimeRef [ il 10 6Chl OHandle ]  . uRelTime) , 

(char  *) SabyRelTime [0]  ,  6); 

return  I106_OK; 

} 


/*  -  */ 

//  Take  a  6  byte  relative  time  value  (like  the  one  in  the  IRIG  header)  and 
//  turn  it  into  a  real  time  based  on  the  current  reference  IRIG  time. 


EnI106Status  I106_CALL_DECL 
enI106_Rel2IrigTime (int 

uint8 


{ 

uint64_t 
int64_t 
int64_t 
int64_t 

int64_t 
int64_t 

uRelTime  =  0L; 
memcpy (SuRelTime 


t 

SuIrigl06Time 

uRelTime ; 
uTimeDif f ; 
lFracDif f ; 
lSecDiff ; 

lSec; 

lFrac; 


SabyRelTime [0] , 


ill 06Chl OHandle 
abyRelTime [ ]  , 

*  psuTime) 


/ /  Figure 
uTimeDif f 
lSecDif f 
lFracDif f 


out  the  relative  time  difference 

=  uRelTime  -  m_asuTimeRef [iI106Chl0Handle] . uRelTime; 
=  uTimeDiff  /  10000000; 

=  uTimeDiff  %  10000000; 


lSec 

lFrac 


=  m_asuTimeRef [ ill 06Chl0Handle ]. suIrigTime . ulSecs  +  lSecDiff; 

=  m_asuTimeRef [ ill 06Chl0Handle ]. suIrigTime . ulFrac  +  lFracDiff; 
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//  This  seems  a  bit  extreme  but  it's  defensive  programming 
while  (lFrac  <  0) 

{ 

lFrac  +=  10000000; 
lSec  -=  1; 

} 


while  (lFrac 

{ 

lFrac  -= 
lSec  += 
} 


>=  10000000) 

10000000; 

1; 


//  Now  add  the  time  difference  to  the  last  IRIG  time  reference 
psuTime->ulFrac  =  (unsigned  long) lFrac; 
psuTime->ulSecs  =  (unsigned  long) lSec; 

return  I106_OK; 

} 


/*  -  */ 

//  Take  a  real  clock  time  and  turn  it  into  a  6  byte  relative  time. 

EnI106Status  I106_CALL_DECL 
enI106_Irig2RelTime (int 

SuIrigl06Time 
uint8_t 

{ 

int64_t  UDiff; 

int64_t  UNewRel; 

//  Calculate  time  difference  (LSB  =  100  nSec)  between  the  passed  time 
//  and  the  time  reference 
UDiff  = 

(int64_t) (+  psuTime->ulSecs  - 
m_asuTimeRef [iI106Chl0Handle] . sulr igTime . ulSecs )  * 

10000000  + 

(int64_t) (+  psuTime->ulFrac  - 
m_asuTimeRef [ ill  0 6 Ch 10 Handle ]  . sulr igTime . u lFrac) ; 

//  Add  this  amount  to  the  reference 

UNewRel  =  m_asuTimeRef  [ il  10 6Chl OHandle]  .  uRelTime  +  UDiff; 

//  Now  convert  this  to  a  6  byte  relative  time 
memcpy((char  * ) SabyRelTime [ 0 ] , 

(char  *)&  (UNewRel)  ,  6); 

return  I106_OK; 

} 


ill 06Chl OHandle, 
*  psuTime, 

abyRelTime [ ] ) 


/* 


*/ 


//  Warning  -  array  to  int  /  int  to  array  functions  are  little  endian  only! 
//  Create  a  6  byte  array  value  from  a  64  bit  int  relative  time 
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void  110  6_CALL_DECL 

vLLInt2TimeArray (int64_t  *  pllRelTime, 

uint8_t  abyRelTime [ ] ) 

{ 

memcpy((char  *) abyRelTime,  (char  *) pllRelTime,  6); 
return ; 

} 


/*  -  */ 

//  Create  a  64  bit  int  relative  time  from  6  byte  array  value 
void  I106_CALL_DECL 

vTimeArray2LLInt (uint8_t  abyRelTime [ ] , 
int64_t  *  pllRelTime) 

{ 

*pllRelTime  =  0L; 

memcpy((char  *) pllRelTime,  (char  *) abyRelTime,  6); 
return ; 

} 


/* 


*/ 


//  Read  the  data  file  from  the  current  position  to  try  to  determine  a  valid 
//  relative  time  to  clock  time  from  a  time  packet. 


EnI106Status  1106  CALL  DECL 


enll 06_SyncTime (int 
int 
int 


il 10  6Chl OHandle, 
bRequireSync, 
iTimeLimit ) 


int64_t 

int64_t 

int64_t 

EnI106Status 

EnI106Status 

SuI106Chl0Header 

SuIrigl06Time 

unsigned  long 

void  * 

SuTimeFl_ChanSpec  * 


HCurrOf  fset; 

1 ITimeLimit ; 
HCurrTime  ; 
enStatus ; 
enRetStatus; 
suI106Hdr; 
suTime ; 

ulBuffSize  =  0; 
pvBuff  =  NULL; 
psuChanSpecTime; 


psuChanSpecTime  =  (SuTimeFl_ChanSpec  *)pvBuff; 

//  Get  and  save  the  current  file  position 

enStatus  =  enI106Chl0GetPos (iI106Chl0Handle,  SllCurrOf f set) ; 
if  (enStatus  !=  I106_OK) 
return  enStatus; 


//  Read  the  first  header 

enStatus  =  enI106Chl0ReadNextHeaderFile (iI106Chl0Handle,  &suI106Hdr) ; 
if  (enStatus  ==  I106_EOF) 

return  I106_TIME_NOT_FOUND; 

if  (enStatus  !=  I106_OK) 
return  enStatus; 

//  Calculate  the  time  limit  if  there  is  one 
if  (iTimeLimit  >  0) 

{ 
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vTimeArray2LLInt ( sul 10 6Hdr . aubyRef Time,  &llTimeLimit) ; 

UTimeLimit  =  UTimeLimit  +  (int64_t)  iTimeLimit  *  ( int64_t)  10000000 ; 

} 

else 

UTimeLimit  =  0; 

//  Loop,  looking  for  appropriate  time  message 
while  (bTRUE) 

{ 

//  See  if  we've  passed  our  time  limit 
if  (UTimeLimit  >  0) 

{ 

vTimeArray2LLInt  ( sul  10  6Hdr  .  aubyRef  Time,  StllCurrTime)  ; 
if  (UTimeLimit  <  HCurrTime) 

{ 

enRetStatus  =  I106_TIME_NOT_FOUND; 
break; 

} 

}  //  end  if  there  is  a  time  limit 
//  If  IRIG  time  type  then  process  it 

if  ( sull 06Hdr . ubyDataType  ==  I106CH10_DTYPE_IRIG_TIME) 

{ 

//  Read  header  OK,  make  buffer  for  time  message 
if  (ulBuffSize  <  sul 10 6Hdr . ulPacketLen) 

{ 

pvBuff  =  realloc (pvBuff,  sul 106Hdr . ulPacketLen) ; 
ulBuffSize  =  sul 10 6Hdr . ulPacketLen; 

} 

//  Read  the  data  buffer 

enStatus  =  enI106Chl0ReadData (iI106Chl0Handle,  ulBuffSize,  pvBuff); 
if  (enStatus  !=  I106_OK) 

{ 

enRetStatus  =  I106_TIME_NOT_FOUND; 
break; 

} 

//  If  external  sync  OK  then  decode  it  and  set  relative  time 

if  ( (bRequireSync  ==  bFALSE)  | |  (psuChanSpecTime->uTimeSrc  ==  1)) 

{ 

enI106_Decode_TimeFl (&suI106Hdr,  pvBuff,  SsuTime) ; 

enll 06_SetRelTime (iI106Chl OHandle,  SsuTime,  sul 10  6Hdr . aubyRef Time) 

enRetStatus  =  I106_OK; 

break; 

} 

}  //  end  if  IRIG  time  message 
//  read  the  next  header  and  try  again 

enStatus  =  enI106Chl0ReadNextHeaderFile (iI106Chl0Handle,  &suI106Hdr) ; 
if  (enStatus  ==  I106_EOF) 

{ 

enRetStatus  =  I106_TIME_NOT_FOUND; 
break; 

} 

if  (enStatus  !=  I106_OK) 

{ 

enRetStatus  =  enStatus; 
break; 

} 
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}  //  end  while  looping  looking  for  time  message 
//  Restore  file  position 

enStatus  =  enI106Chl0SetPos (iI106Chl0Handle,  HCurrOf fset)  ; 
if  (enStatus  !=  I106_OK) 

{ 

enRetStatus  =  enStatus; 

} 


//  Return  the  malloc'ed  memory 
free (pvBuff) ; 

return  enRetStatus; 

} 


/* 


*/ 


EnI106Status  I106_CALL_DECL 

enI106Chl0SetPosToIrigTime (int  iHandle,  SuIrigl06Time  *  psuSeekTime) 

{ 

uint8_t  abySeekTime [ 6] ; 

int64_t  USeekTime; 

Sulndex  *  psulndex  =  &g_sull 06Handle [ iHandle] . sulndex; 

int  iUpperLimit; 

int  iLowerLimit; 

int  iSearchLoopIdx; 


//  If  there  is  no  index  in  memory  then  barf 
if  (psuIndex->enSortStatus  !=  enSorted) 
return  I106_NO_INDEX; 

//We  have  an  index  so  do  a  binary  search  for  time 


//  Convert  clock  time  to  10  MHz  count 

enI106_Irig2RelTime (iHandle,  psuSeekTime,  abySeekTime); 
vTimeArray2LLInt  (abySeekTime,  &HSeekTime)  ; 

//  Check  time  bounds 

if  (USeekTime  <  psulndex->asulndex  [ 0 ]  .  UTime) 

{ 

enI106Chl0FirstMsg (iHandle)  ; 
return  I106_TIME_NOT_FOUND; 

}  ; 


if  (USeekTime  >  psulndex->asulndex  [psuIndex->iArrayUsed]  .  UTime) 

{ 

enll 06Chl0LastMsg ( iHandle) ; 
return  I106_TIME_NOT_FOUND; 

}  ; 

//  If  we  don't  already  have  it,  figure  out  how  many  search  steps 
if  (psuIndex->iNumSearchSteps  ==  0) 

{ 

iUpperLimit  =  1; 

while  (iUpperLimit  <  psuIndex->iArrayUsed) 

{ 

iUpperLimit  *=  2; 
psuIndex->iNumSearchSteps+t ; 

} 

}  //  end  if  no  search  steps 
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//  Loop  prescribed  number  of  times 
iLowerLimit  =  0; 

iUpperLimit  =  psuIndex->iArrayUsed-l ; 

psuIndex->iArrayCurr  =  (iUpperLimit  -  iLowerLimit)  /  2; 
for  ( iSearchLoopIdx  =  0; 

iSearchLoopIdx  <  psuIndex->iNumSearchSteps; 
iSearchLoopIdx++) 

{ 

if  (psulndex->asulndex [psuIndex->iArrayCurr ] . UTime  >  USeekTime) 

iUpperLimit  =  (iUpperLimit  -  iLowerLimit)  /  2; 
else  if  (psulndex->asulndex [psuIndex->iArrayCurr ] . UTime  <  USeekTime) 
iLowerLimit  =  (iUpperLimit  -  iLowerLimit)  /  2; 

else 

break; 

} 


return  I106_OK; 

} 


/*  -  */ 

//  General  purpose  time  utilities 
// - 

//  Convert  IRIG  time  into  an  appropriate  string 

char  *  IrigTime2String (SuIrigl06Time  *  psuTime) 

{ 

static  char  szTime [30]; 

struct  tm  *  psuTmTime; 

//  Convert  IRIG  time  into  it's  components 
psuTmTime  =  gmtime ( ( time_t  * ) & (psuTime->ulSecs)  )  ; 

//  Make  the  appropriate  string 
switch  (psuTime->enFmt) 

{ 

//  Day  /  Month  /  Year  format  ("001:12:34:56.789") 
case  110  6_DATEFMT_DMY  : 

sprintf ( szTime,  "%4 . 4i/%2 . 2i/%2 . 2i  %2 . 2i : %2 . 2i : %2 . 2i . %3 . 3i", 
psuTmTime->tm_year  +  1900, 
psuTmTime->tm_mon  +  1, 
psuTmTime->tm_mday , 
psuTmTime->tm_hour , 
psuTmTime->tm_min, 
psuTmTime->tm_sec, 
psuTime->ulFrac  /  10000) ; 
break; 

//  Day  of  the  Year  format  ("2008/02/29  12:34:56.789") 
case  110  6_DATEFMT_DAY  : 
default  : 

sprintf ( szTime,  "%3.3i:%2.2i:%2.2i:%2.2i.%3.3i", 
psuTmTime->tm_ydaytl , 
psuTmTime->tm_hour , 
psuTmTime->tm_min, 
psuTmTime->tm_sec, 
psuTime->ulFrac  /  10000) ; 
break; 

}  //  end  switch  on  format 
return  szTime; 
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/* 


*/ 


/*  Return  the  equivalent  in  seconds  past  12:00:00  a.m.  Jan  1,  1970  GMT 

of  the  Greenwich  Mean  time  and  date  in  the  exploded  time  structure  'tm'. 

The  standard  mktimeO  has  the  annoying  "feature"  of  assuming  that  the 
time  in  the  tm  structure  is  local  time,  and  that  it  has  to  be  corrected 
for  local  time  zone.  In  this  library  time  is  assumed  to  be  UTC  and  UTC 
only.  To  make  sure  no  timezone  correction  is  applied  this  time  conversion 
routine  was  lifted  from  the  standard  C  run  time  library  source.  Interestingly 
enough,  this  routine  was  found  in  the  source  for  mktimeO . 

This  function  does  always  put  back  normalized  values  into  the  'tm'  struct, 
parameter,  including  the  calculated  numbers  for  ' tm->tm_yday ' , 

' tm->tm_wday ' ,  and  ' tm->tm_isdst 1 . 

Returns  -1  if  the  time  in  the  'tm'  parameter  cannot  be  represented 
as  valid  'time  t'  number. 


//  Number  of  leap  years  from  1970  to  'y'  (not  including  'y'  itself) . 

#def ine  nleap(y)  ( ( (y)  -  1969)  /  4  -  ( (y)  -  1901)  /  100  +  ( (y)  -  1601)  /  400) 

//  Nonzero  if  'y'  is  a  leap  year,  else  zero. 

#define  leap(y)  ( ( (y)  %  4  ==  0  &&  (y)  %  100  !  =  0)  ||  (y)  %  400  ==  0) 

//  Additional  leapday  in  February  of  leap  years. 

#define  leapday (m,  y)  ( (m)  ==  1  &&  leap  (y)  ) 

#define  ADJUST_TM (tm_member,  tm_carry,  modulus)  \ 
if  ( (tm_member)  <  0)  {  \ 

tm_carry  -=  (1  -  ( ( tm_member ) +1 )  /  (modulus));  \ 
trrwnember  =  (modulus-1)  +  (  (  ( tm_member )  +1 )  %  (modulus));  \ 

}  else  if  ( (tm_member)  >=  (modulus) )  {  \ 

tm_carry  +=  (tm_member)  /  (modulus) ;  \ 
tm_member  =  (tm_member)  %  (modulus) ;  \ 


//  Length  of  month  'm'  (0  ..  11) 

#define  monthlen (m,  y)  ( ydays [ (m) +1 ]  -  ydays [m]  +  leapday  (m,  y) ) 


time_t  110  6_CALL_DECL 

mkgmtime (struct  tm  *  psuTmTime) 

{ 

//  Accumulated  number  of  days  from  01- Jan  up  to  start  of  current  month, 
static  short  ydays []  = 

{ 

0,  31,  59,  90,  120,  151,  181,  212,  243,  273,  304,  334,  365 

}  ; 


int  years,  months,  days. 

hours , 

minutes. 

seconds; 

years  =  psuTmTime->tm 

year  + 

1900; 

// 

year  -  1900  ->  year 

months  =  psuTmTime->tm 

mon; 

// 

0. 

.11 

days  =  psuTmTime->tm 

mday  - 

1; 

// 

1 . 

.31  -> 

0.  .30 

hours  =  psuTmTime->tm 

hour  ; 

// 

0. 

.23 

minutes  =  psuTmTime->tm 

min; 

// 

0. 

.59 

seconds  =  psuTmTime->tm 

sec; 

// 

0. 

.61  in 

ANSI  C. 
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AD JUST_TM ( seconds,  minutes,  60) 

ADJUST_TM (minutes,  hours,  60) 

ADJUST^TM (hours,  days,  24) 

AD JUST_TM (months ,  years,  12) 

if  (days  <  0) 
do 

{ 

if  (--months  <  0) 

{ 

--years ; 
months  =  11; 

} 

days  +=  monthlen (months ,  years); 

}  while  (days  <  0) ; 

else 

while  (days  >=  monthlen (months ,  years)) 

{ 

days  -=  monthlen (months,  years); 
if  (++months  >=  12) 

{ 

++years; 
months  =  0; 

} 

}  //  end  while 

//  Restore  adjusted  values  in  tm  structure 
psuTmTime->tm_year  =  years  -  1900; 
psuTmTime->tm_mon  =  months; 
psuTmTime->tm_mday  =  days  +  1; 
psuTmTime->tm_hour  =  hours; 
psuTmTime->tm_min  =  minutes; 
psuTmTime->tm_sec  =  seconds; 

//  Set  'days'  to  the  number  of  days  into  the  year, 
days  +=  ydays [months ]  +  (months  >  1  &&  leap  (years)); 
psuTmTime->tm_yday  =  days; 

//  Now  calculate  'days'  to  the  number  of  days  since  Jan  1,  1970. 
days  =  (unsigned) days  +  365  *  (unsigned) (years  -  1970)  + 

(unsigned) (nleap  (years) ) ; 

psuTmTime->tm_wday  =  ( (unsigned) days  +  4)  %  7;  /*  Jan  1,  1970  was  Thursday.  */ 
psuTmTime->tm_isdst  =  0; 

if  (years  <  1970) 

return  (time_t)-l; 

return  (time_t) (86400L  *  days  +  3600L  *  hours  +  60L  *  minutes  +  seconds); 

} 
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Appendix  A-5.  il06_decode_time.h 

/**************************************************************************** 
ilO 6_decode_time . h  - 
Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#ifndef  _I106_DECODE_TIME_H 
#def ine  _I106_DECODE_TIME_H 

#include  "irigl06chl0.h" 

#ifdef  _ cplusplus 

extern  "C"  { 

#endif 

/* 

*  Macros  and  definitions 


*/ 

typedef  enum 
{ 


1106  TIMEFMT  IRIG  B 

=  0x00, 

1106  TIMEFMT  IRIG  A 

=  0x01, 

1106  TIMEFMT  IRIG  G 

=  0x02, 

1106  TIMEFMT  INT  RTC 

=  0x03, 

1106  TIMEFMT  GPS  UTC 

=  0x04, 

1106  TIMEFMT  GPS  NATIVE 
}  EnI106TimeFmt; 

=  0x05, 
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/* 

*  Data  structures 

*  _ 

*/ 

/*  Time  Format  1  */ 

#if  defined (_MSC_VER) 
#pragma  pack (push) 

#pragma  pack(l) 

#endif 

//  Channel  specific  header 
typedef  struct 
{ 


uint32 

t 

uTimeSrc 

4; 

// 

Time 

source 

uint32 

t 

uTimeFmt 

4; 

// 

Time 

format 

uint32 

t 

bLeapYear 

1; 

// 

Leap 

year 

uint32 

t 

uDateFmt 

1; 

// 

Date 

format 

uint32 

t 

uReserved2 

2; 

uint32 

t 

uReserved3 

16; 

#if  ! defined ( _ GNUC _ ) 

}  SuTimeFl_ChanSpec; 

#else 

}  _ attribute _  ( (packed) )  SuTimeFl^ChanSpec; 

#endif 

//  Time  message  -  Day  format 
typedef  struct 
{ 


uintl 6 

t 

uTmn 

4; 

// 

Tens  of  milliseconds 

uintl 6 

t 

uHmn 

4; 

// 

Hundreds  of  milliseconds 

uintl 6 

t 

uSn 

4; 

// 

Units  of  seconds 

uintl 6 

t 

uTSn 

3; 

// 

Tens  of  seconds 

uintl 6 

t 

Reservedl 

1; 

// 

0 

uintl 6 

t 

uMn 

4; 

// 

Units  of  minutes 

uintl 6 

t 

uTMn 

3; 

// 

Tens  of  minutes 

uintl 6 

t 

Reserved2 

1; 

// 

0 

uintl 6 

t 

uHn 

4; 

// 

Units  of  hours 

uintl 6 

t 

uTHn 

2; 

// 

Tens  of  Hours 

uintl 6 

t 

Reserved3 

2; 

// 

0 

uintl 6 

t 

uDn 

4; 

// 

Units  of  day  number 

uintl 6 

t 

uTDn 

4; 

// 

Tens  of  day  number 

uintl 6 

t 

uHDn 

2; 

// 

Hundreds  of  day  number 

uintl 6 

t 

Reserved4 

6; 

// 

0 

#if  ! defined ( _ GNUC _ ) 

}  SuTime_MsgDayFmt; 

#else 

}  _ attribute _  ( (packed) )  SuTime_MsgDayFmt; 

#endif 

//  Time  message  -  DMY  format 
typedef  struct 
{ 


uintl 6 

t 

uTmn 

4; 

// 

Tens  of  milliseconds 

uintl 6 

t 

uHmn 

4; 

// 

Hundreds  of  milliseconds 

uintl 6 

t 

uSn 

4; 

// 

Units  of  seconds 

uintl 6 

t 

uTSn 

3; 

// 

Tens  of  seconds 

uintl 6 

t 

Reservedl 

1; 

// 

0 
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uintl 6 

t 

uMn 

4; 

// 

Units  of  minutes 

uintl 6 

t 

uTMn 

3; 

// 

Tens  of  minutes 

uintl 6 

t 

Reserved2 

1; 

// 

0 

uintl 6 

t 

uHn 

4; 

// 

Units  of  hours 

uintl 6 

t 

uTHn 

2; 

// 

Tens  of  Hours 

uintl 6 

t 

Reserved3 

2; 

// 

0 

uintl 6 

t 

uDn 

4; 

// 

Units  of  day  number 

uintl 6 

t 

uTDn 

4; 

// 

Tens  of  day  number 

uintl 6 

t 

uOn 

4; 

// 

Units  of  month  number 

uintl 6 

t 

uTOn 

1; 

// 

Tens  of  month  number 

uintl 6 

t 

Reserved4 

3; 

// 

0 

uintl 6 

t 

uYn 

4; 

// 

Units  of  year  number 

uintl 6 

t 

uTYn 

4; 

// 

Tens  of  year  number 

uintl 6 

t 

uHYn 

4; 

// 

Hundreds  of  year  number 

uintl 6 

t 

uOYn 

2; 

// 

Thousands  of  year  number 

uintl 6 

t 

Reserved5 

2; 

// 

0 

#if  ! defined ( _ GNUC _ ) 

}  SuTime_MsgDmyFmt; 

#else 

}  _ attribute _  ( (packed) )  SuTime_MsgDmyFmt; 

#endif 

#if  defined (_MSC_VER) 

#pragma  pack (pop) 

#endif 


/* 

*  Function  Declaration 

*  _ 

*/ 

EnI106Status  I106_CALL_DECL 

enI106_Decode_TimeFl (SuI106Chl0Header  *  psuHeader, 

void  *  pvBuff, 

SuIrigl06Time  *  psuTime) ; 

EnI106Status  I106_CALL_DECL 

enI106_Encode_TimeFl (SuI106Chl0Header  *  psuHeader, 

unsigned  int  uExtTime, 

unsigned  int  uFmtTime, 

unsigned  int  uFmtDate, 

SuIrigl06Time  *  psuTime, 

void  *  pvBuf f TimeFl ) ; 

#ifdef  _ cplusplus 

} 

#endif 

#endif 
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Appendix  A-6.  il06_decode_time.c 

/**************************************************************************** 
il06_decode_time. c  - 
Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <time.h> 

#include  <sys/types . h> 

#include  <sys/timeb . h> 

#if  defined (_WIN32 ) 

#include  <windows.h>  //  For  FILETIME 

#endif 

#include  "stdint.h" 

#include  "irigl06chl0 . h" 

#include  "il06_time.h" 

#include  "il06_decode_time .h" 

/* 

*  Macros  and  definitions 

*  _ 

*/ 


/* 
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*  Data  structures 


*/ 

Day  and  Month 

//  Month  0-11 
//  Day  of  month  1-31 

/* 

*  Module  data 


//  Day  of  Year  to 
typedef  struct 
{ 

int  iMonth; 
int  iDay; 

}  SuDOY2DM; 


*/ 


//  SuTimeRef  m  suCurrRef Time ; 


//  Current  value  of  IRIG  reference  time 


//  These  structures  are  used  to  convert  from  day  of  the  year  format  to 
//  day  and  month.  One  is  for  normal  years  and  the  other  is  for  leap  years. 
//  The  values  and  index  are  of  the  "struct  tm"  notion.  That  is,  the  day  of 
//  the  year  index  is  number  of  days  since  Jan  1st,  i.e.,  Jan  1st  =  0.  For 
//  IRIG  time,  Jan  1st  =  1.  The  month  value  is  months  since  January,  i.e., 
//  Jan  =  0.  Don't  get  confused! 


SuDOY2DM  suDoy2DmNormal [ ] 


0, 

1}, 

{ 

0, 

2}, 

{ 

0, 

3}, 

{ 

0, 

4}, 

{ 

0, 

5}, 

{ 

0, 

6}, 

{ 

0, 

7}, 

{ 

0, 

8} 

0, 

9}, 

{ 

0, 

10}, 

{ 

0, 

11}, 

{ 

0, 

12}, 

{ 

0, 

13}, 

{ 

0, 

14}, 

{ 

0, 

15}, 

{ 

0, 

16} 

0, 

17}, 

{ 

0, 

18}, 

{ 

0, 

19}, 

{ 

0, 

20}, 

{ 

0, 

21}, 

{ 

0, 

22}, 

{ 

0, 

23}, 

{ 

0, 

24  } 

0, 

25}, 

{ 

0, 

26}, 

{ 

0, 

27}, 

{ 

0, 

28}, 

{ 

0, 

29}, 

{ 

0, 

30}, 

{ 

0, 

31}, 

{ 

1, 

1} 

1, 

2}, 

{ 

1, 

3}, 

{ 

1, 

4}, 

{ 

1, 

5}, 

{ 

1, 

6}, 

{ 

1, 

7}, 

{ 

1, 

8}, 

{ 

1, 

9} 

1, 

10}, 

{ 

1, 

11}, 

{ 

1, 

12}, 

{ 

1, 

13}, 

{ 

1, 

14}, 

{ 

1, 

15}, 

{ 

1, 

16}, 

{ 

1, 

17} 

1, 

18}, 

{ 

1, 

19}, 

{ 

1, 

20}, 

{ 

1, 

21}, 

{ 

1, 

22}, 

{ 

1, 

23}, 

{ 

1, 

24}, 

{ 

1, 

25} 

1, 

26}, 

{ 

1, 

27}, 

{ 

1, 

28}, 

{ 

2, 

1}, 

{ 

2, 

2}, 

{ 

2, 

3}, 

{ 

2, 

4}, 

{ 

2, 

5} 

2, 

6}, 

{ 

2, 

7}, 

{ 

2, 

8}, 

{ 

2, 

9}, 

{ 

2, 

10}, 

{ 

2, 

11}, 

{ 

2, 

12}, 

{ 

2, 

13} 

2, 

14}, 

{ 

2, 

15}, 

{ 

2, 

16}, 

{ 

2, 

17}, 

{ 

2, 

18}, 

{ 

2, 

19}, 

{ 

2, 

20}, 

{ 

2, 

21 } 

2, 

22}, 

{ 

2, 

23}, 

{ 

2, 

24}, 

{ 

2, 

25}, 

{ 

2, 

26}, 

{ 

2, 

27}, 

{ 

2, 

28}, 

{ 

2, 

29} 

2, 

30}, 

{ 

2, 

31}, 

{ 

3, 

1}, 

{ 

3, 

2}, 

{ 

3, 

3}, 

{ 

3, 

4}, 

{ 

3, 

5}, 

{ 

3, 

6} 

3, 

7}, 

{ 

3, 

8}, 

{ 

3, 

9}, 

{ 

3, 

10}, 

{ 

3, 

11}, 

{ 

3, 

12}, 

{ 

3, 

13}, 

{ 

3, 

14  } 

3, 

15}, 

{ 

3, 

16}, 

{ 

3, 

17}, 

{ 

3, 

18}, 

{ 

3, 

19}, 

{ 

3, 

20}, 

{ 

3, 

21}, 

{ 

3, 

22} 

3, 

23}, 

{ 

3, 

24}, 

{ 

3, 

25}, 

{ 

3, 

26}, 

{ 

3, 

27}, 

{ 

3, 

28}, 

{ 

3, 

29}, 

{ 

3, 

30} 

4, 

1}, 

{ 

4, 

2}, 

{ 

4, 

3}, 

{ 

4, 

4}, 

{ 

4, 

5}, 

{ 

4, 

6}, 

{ 

4, 

7}, 

{ 

4, 

8} 

4, 

9}, 

{ 

4, 

10}, 

{ 

4, 

11}, 

{ 

4, 

12}, 

{ 

4, 

13}, 

{ 

4, 

14}, 

{ 

4, 

15}, 

{ 

4, 

16} 

4, 

17}, 

{ 

4, 

18}, 

{ 

4, 

19}, 

{ 

4, 

20}, 

{ 

4, 

21}, 

{ 

4, 

22}, 

{ 

4, 

23}, 

{ 

4, 

24  } 

4, 

25}, 

{ 

4, 

26}, 

{ 

4, 

27}, 

{ 

4, 

28}, 

{ 

4, 

29}, 

{ 

4, 

30}, 

{ 

4, 

31}, 

{ 

5, 

1} 

5, 

2}, 

{ 

5, 

3}, 

{ 

5, 

4}, 

{ 

5, 

5}, 

{ 

5, 

6}, 

{ 

5, 

7}, 

{ 

5, 

8}, 

{ 

5, 

9} 

5, 

10}, 

{ 

5, 

11}, 

{ 

5, 

12}, 

{ 

5, 

13}, 

{ 

5, 

14}, 

{ 

5, 

15}, 

{ 

5, 

16}, 

{ 

5, 

17  } 

5, 

18}, 

{ 

5, 

19}, 

{ 

5, 

20}, 

{ 

5, 

21}, 

{ 

5, 

22}, 

{ 

5, 

23}, 

{ 

5, 

24}, 

{ 

5, 

25} 

5, 

26}, 

{ 

5, 

27}, 

{ 

5, 

28}, 

{ 

5, 

29}, 

{ 

5, 

30}, 

{ 

6, 

1}, 

{ 

6, 

2}, 

{ 

6, 

3} 

6, 

4}, 

{ 

6, 

5}, 

{ 

6, 

6}, 

{ 

6, 

7}, 

{ 

6, 

8}, 

{ 

6, 

9}, 

{ 

6, 

10}, 

{ 

6, 

11 } 

6, 

12}, 

{ 

6, 

13}, 

{ 

6, 

14}, 

{ 

6, 

15}, 

{ 

6, 

16}, 

{ 

6, 

17}, 

{ 

6, 

18}, 

{ 

6, 

19} 

6, 

20}, 

{ 

6, 

21}, 

{ 

6, 

22}, 

{ 

6, 

23}, 

{ 

6, 

24}, 

{ 

6, 

25}, 

{ 

6, 

26}, 

{ 

6, 

27  } 

6, 

28}, 

{ 

6, 

29}, 

{ 

6, 

30}, 

{ 

6, 

31}, 

{ 

7, 

1}, 

{ 

7, 

2}, 

{ 

7, 

3}, 

{ 

7, 

4} 

7, 

5}, 

{ 

7, 

6}, 

{ 

7, 

7}, 

{ 

7, 

8}, 

{ 

7, 

9}, 

{ 

7, 

10}, 

{ 

7, 

11}, 

{ 

7, 

12  } 

7, 

13}, 

{ 

7, 

14}, 

{ 

7, 

15}, 

{ 

7, 

16}, 

{ 

7, 

17}, 

{ 

7, 

18}, 

{ 

7, 

19}, 

{ 

7, 

20} 

7, 

21}, 

{ 

7, 

22}, 

{ 

7, 

23}, 

{ 

7, 

24}, 

{ 

7, 

25}, 

{ 

7, 

26}, 

{ 

7, 

27}, 

{ 

7, 

28} 

7, 

29}, 

{ 

7, 

30}, 

{ 

7, 

31}, 

{ 

8, 

1}, 

{ 

8, 

2}, 

{ 

8, 

3}, 

{ 

8, 

4}, 

{ 

8, 

5} 

8, 

6}, 

{ 

8, 

7}, 

{ 

8, 

8}, 

{ 

8, 

9}, 

{ 

8, 

10}, 

{ 

8, 

11}, 

{ 

8, 

12}, 

{ 

8, 

13} 

8, 

14}, 

{ 

8, 

15}, 

{ 

8, 

16}, 

{ 

8, 

17}, 

{ 

8, 

18}, 

{ 

8, 

19}, 

{ 

8, 

20}, 

{ 

8, 

21 } 

8, 

22}, 

{ 

8, 

23}, 

{ 

8, 

24}, 

{ 

8, 

25}, 

{ 

8, 

26}, 

{ 

8, 

27}, 

{ 

8, 

28}, 

{ 

8, 

29} 

8, 

30}, 

{ 

9, 

1}, 

{ 

9, 

2}, 

{ 

9, 

3}, 

{ 

9, 

4}, 

{ 

9, 

5}, 

{ 

9, 

6}, 

{ 

9, 

7} 

9, 

8}, 

{ 

9, 

9}, 

{ 

9, 

10}, 

{ 

9, 

11}, 

{ 

9, 

12}, 

{ 

9, 

13}, 

{ 

9, 

14}, 

{ 

9, 

15} 
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{  9, 

16}, 

{ 

9, 

17}, 

{ 

9, 

18}, 

{  9, 

19}, 

{  9, 

20}, 

{ 

9, 

21}, 

{ 

9, 

22}, 

{ 

9, 

23} 

{  9, 

24}, 

{ 

9, 

25}, 

{ 

9, 

26}, 

{  9, 

27}, 

{  9, 

28}, 

{ 

9, 

29}, 

{ 

9, 

30}, 

{ 

9, 

31} 

{10, 

1}, 

{10, 

2}, 

{10, 

3}, 

{10, 

4}, 

{10, 

5}, 

{10, 

6}, 

{10, 

7}, 

{10, 

8} 

{10, 

9}, 

{10, 

10}, 

{10, 

11}, 

{10, 

12}, 

{10, 

13}, 

{10, 

14}, 

{10, 

15}, 

{10, 

16} 

{10, 

17}, 

{10, 

18}, 

{10, 

19}, 

{10, 

20}, 

{10, 

21}, 

{10, 

22}, 

{10, 

23}, 

{10, 

24  } 

{10, 

25}, 

{10, 

26}, 

{10, 

27}, 

{10, 

28}, 

{10, 

29}, 

{10, 

30}, 

{11, 

1}, 

{11, 

2} 

{11, 

3}, 

{11, 

4}, 

{11, 

5}, 

{11, 

6}, 

{11, 

7}, 

{11, 

8}, 

{11, 

9}, 

Ul, 

10} 

{11, 

11}, 

{11, 

12}, 

{11, 

13}, 

{11, 

14}, 

{11, 

15}, 

{11, 

16}, 

{11, 

17}, 

{11, 

18} 

{11, 

19}, 

{11, 

20}, 

{11, 

21}, 

{11, 

22}, 

{11, 

23}, 

{11, 

24}, 

{11, 

25}, 

{11, 

26} 

{11, 

27}, 

{11, 

28}, 

{11, 

29}, 

{11, 

30}, 

{11, 

31} 

} ; 

SuDOY2DM 

suDoy2DmLeap [ ] 

=  { 

{  o. 

1}, 

{ 

0, 

2}, 

{ 

0, 

3}, 

{  o. 

4}, 

{  o. 

5}, 

{ 

0, 

6}, 

{ 

0, 

7}, 

{ 

0, 

8} 

{  o. 

9}, 

{ 

0, 

10}, 

{ 

0, 

11}, 

{  o. 

12}, 

{  o. 

13}, 

{ 

0, 

14}, 

{ 

0, 

15}, 

{ 

0, 

16} 

{  o. 

17}, 

{ 

0, 

18}, 

{ 

0, 

19}, 

{  o. 

20}, 

{  o. 

21}, 

{ 

0, 

22}, 

{ 

0, 

23}, 

{ 

0, 

24  } 

{  o. 

25}, 

{ 

0, 

26}, 

{ 

0, 

27}, 

{  o. 

28}, 

{  o. 

29}, 

{ 

0, 

30}, 

{ 

0, 

31}, 

{ 

1, 

1} 

{  1, 

2}, 

{ 

1, 

3}, 

{ 

1, 

4}, 

{  1, 

5}, 

{  1, 

6}, 

{ 

1, 

7}, 

{ 

1, 

8}, 

{ 

1, 

9} 

{  1, 

10}, 

{ 

1, 

11}, 

{ 

1, 

12}, 

{  1, 

13}, 

{  1, 

14}, 

{ 

1, 

15}, 

{ 

1, 

16}, 

{ 

1, 

17} 

{  1, 

18}, 

{ 

1, 

19}, 

{ 

1, 

20}, 

{  1, 

21}, 

{  1, 

22}, 

{ 

1, 

23}, 

{ 

1, 

24}, 

{ 

1, 

25} 

{  1, 

26}, 

{ 

1, 

27}, 

{ 

1, 

28}, 

{  1, 

29}, 

{  2, 

1}, 

{ 

2, 

2}, 

{ 

2, 

3}, 

{ 

2, 

4} 

{  2, 

5}, 

{ 

2, 

6}, 

{ 

2, 

7}, 

{  2, 

8}, 

{  2, 

9}, 

{ 

2, 

10}, 

{ 

2, 

11}, 

{ 

2, 

12  } 

{  2, 

13}, 

{ 

2, 

14}, 

{ 

2, 

15}, 

{  2, 

16}, 

{  2, 

17}, 

{ 

2, 

18}, 

{ 

2, 

19}, 

{ 

2, 

20} 

{  2, 

21}, 

{ 

2, 

22}, 

{ 

2, 

23}, 

{  2, 

24}, 

{  2, 

25}, 

{ 

2, 

26}, 

{ 

2, 

27}, 

{ 

2, 

28} 

{  2, 

29}, 

{ 

2, 

30}, 

{ 

2, 

31}, 

{  3, 

1}, 

{  3, 

2}, 

{ 

3, 

3}, 

{ 

3, 

4}, 

{ 

3, 

5} 

{  3, 

6}, 

{ 

3, 

7}, 

{ 

3, 

8}, 

{  3, 

9}, 

{  3, 

10}, 

{ 

3, 

11}, 

{ 

3, 

12}, 

{ 

3, 

13} 

{  3, 

14}, 

{ 

3, 

15}, 

{ 

3, 

16}, 

{  3, 

17}, 

{  3, 

18}, 

{ 

3, 

19}, 

{ 

3, 

20}, 

{ 

3, 

21 } 

{  3, 

22}, 

{ 

3, 

23}, 

{ 

3, 

24}, 

{  3, 

25}, 

{  3, 

26}, 

{ 

3, 

27}, 

{ 

3, 

28}, 

{ 

3, 

29} 

{  3, 

30}, 

{ 

4, 

1}, 

{ 

4, 

2}, 

{  4, 

3}, 

{  4, 

4}, 

{ 

4, 

5}, 

{ 

4, 

6}, 

{ 

4, 

7} 

{  4, 

8}, 

{ 

4, 

9}, 

{ 

4, 

10}, 

{  4, 

11}, 

{  4, 

12}, 

{ 

4, 

13}, 

{ 

4, 

14}, 

{ 

4, 

15} 

{  4, 

16}, 

{ 

4, 

17}, 

{ 

4, 

18}, 

{  4, 

19}, 

{  4, 

20}, 

{ 

4, 

21}, 

{ 

4, 

22}, 

{ 

4, 

23} 

{  4, 

24}, 

{ 

4, 

25}, 

{ 

4, 

26}, 

{  4, 

27}, 

{  4, 

28}, 

{ 

4, 

29}, 

{ 

4, 

30}, 

{ 

4, 

31} 

{  5, 

1}, 

{ 

5, 

2}, 

{ 

5, 

3}, 

{  5, 

4}, 

{  5, 

5}, 

{ 

5, 

6}, 

{ 

5, 

7}, 

{ 

5, 

8} 

{  5, 

9}, 

{ 

5, 

10}, 

{ 

5, 

11}, 

{  5, 

12}, 

{  5, 

13}, 

{ 

5, 

14}, 

{ 

5, 

15}, 

{ 

5, 

16} 

{  5, 

17}, 

{ 

5, 

18}, 

{ 

5, 

19}, 

{  5, 

20}, 

{  5, 

21}, 

{ 

5, 

22}, 

{ 

5, 

23}, 

{ 

5, 

24  } 

{  5, 

25}, 

{ 

5, 

26}, 

{ 

5, 

27}, 

{  5, 

28}, 

{  5, 

29}, 

{ 

5, 

30}, 

{ 

6, 

1}, 

{ 

6, 

2} 

{  6, 

3}, 

{ 

6, 

4}, 

{ 

6, 

5}, 

{  6, 

6}, 

{  6, 

7}, 

{ 

6, 

8}, 

{ 

6, 

9}, 

{ 

6, 

10} 

{  6, 

11}, 

{ 

6, 

12}, 

{ 

6, 

13}, 

{  6, 

14}, 

{  6, 

15}, 

{ 

6, 

16}, 

{ 

6, 

17}, 

{ 

6, 

18} 

{  6, 

19}, 

{ 

6, 

20}, 

{ 

6, 

21}, 

{  6, 

22}, 

{  6, 

23}, 

{ 

6, 

24}, 

{ 

6, 

25}, 

{ 

6, 

26} 

{  6, 

27}, 

{ 

6, 

28}, 

{ 

6, 

29}, 

{  6, 

30}, 

{  6, 

31}, 

{ 

7, 

1}, 

{ 

7, 

2}, 

{ 

7, 

3} 

{  7, 

4}, 

{ 

7, 

5}, 

{ 

7, 

6}, 

{  7, 

7}, 

{  7, 

8}, 

{ 

7, 

9}, 

{ 

7, 

10}, 

{ 

7, 

11 } 

{  7, 

12}, 

{ 

7, 

13}, 

{ 

7, 

14}, 

{  7, 

15}, 

{  7, 

16}, 

{ 

7, 

17}, 

{ 

7, 

18}, 

{ 

7, 

19} 

{  7, 

20}, 

{ 

7, 

21}, 

{ 

7, 

22}, 

{  7, 

23}, 

{  7, 

24}, 

{ 

7, 

25}, 

{ 

7, 

26}, 

{ 

7, 

27  } 

{  7, 

28}, 

{ 

7, 

29}, 

{ 

7, 

30}, 

{  7, 

31}, 

{  8, 

1}, 

{ 

8, 

2}, 

{ 

8, 

3}, 

{ 

8, 

4} 

{  8, 

5}, 

{ 

8, 

6}, 

{ 

8, 

7}, 

{  8, 

8}, 

{  8, 

9}, 

{ 

8, 

10}, 

{ 

8, 

11}, 

{ 

8, 

12  } 

{  8, 

13}, 

{ 

8, 

14}, 

{ 

8, 

15}, 

{  8, 

16}, 

{  8, 

17}, 

{ 

8, 

18}, 

{ 

8, 

19}, 

{ 

8, 

20} 

{  8, 

21}, 

{ 

8, 

22}, 

{ 

8, 

23}, 

{  8, 

24}, 

{  8, 

25}, 

{ 

8, 

26}, 

{ 

8, 

27}, 

{ 

8, 

28} 

{  8, 

29}, 

{ 

8, 

30}, 

{ 

9, 

1}, 

{  9, 

2}, 

{  9, 

3}, 

{ 

9, 

4}, 

{ 

9, 

5}, 

{ 

9, 

6} 

{  9, 

7}, 

{ 

9, 

8}, 

{ 

9, 

9}, 

{  9, 

10}, 

{  9, 

11}, 

{ 

9, 

12}, 

{ 

9, 

13}, 

{ 

9, 

14  } 

{  9, 

15}, 

{ 

9, 

16}, 

{ 

9, 

17}, 

{  9, 

18}, 

{  9, 

19}, 

{ 

9, 

20}, 

{ 

9, 

21}, 

{ 

9, 

22} 

{  9, 

23}, 

{ 

9, 

24}, 

{ 

9, 

25}, 

{  9, 

26}, 

{  9, 

27}, 

{ 

9, 

28}, 

{ 

9, 

29}, 

{ 

9, 

30} 

{  9, 

31}, 

{10, 

1}, 

{10, 

2}, 

{10, 

3}, 

{10, 

4}, 

{10, 

5}, 

{10, 

6}, 

{10, 

7} 

{10, 

8}, 

{10, 

9}, 

{10, 

10}, 

{10, 

11}, 

{10, 

12}, 

{10, 

13}, 

{10, 

14}, 

{10, 

15} 

{10, 

16}, 

{10, 

17}, 

{10, 

18}, 

{10, 

19}, 

{10, 

20}, 

{10, 

21}, 

{10, 

22}, 

{10, 

23} 

{10, 

24}, 

{10, 

25}, 

{10, 

26}, 

{10, 

27}, 

{10, 

28}, 

{10, 

29}, 

{10, 

30}, 

Ul, 

1} 

{11, 

2}, 

{11, 

3}, 

{11, 

4}, 

{11, 

5}, 

{11, 

6}, 

{11, 

7}, 

{11, 

8}, 

{11, 

9} 

{11, 

10}, 

{11, 

11}, 

{11, 

12}, 

{11, 

13}, 

{11, 

14}, 

{11, 

15}, 

{11, 

16}, 

Ul, 

17} 

{11, 

18}, 

{11, 

19}, 

{11, 

20}, 

{11, 

21}, 

{11, 

22}, 

{11, 

23}, 

{11, 

24}, 

Ul, 

25} 

{11, 

26}, 

{11, 

27}, 

{11, 

28}, 

{11, 

29}, 

{11, 

30}, 

{11, 

31} 

}; 

/* 
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*  Function  Declaration 


/ *  =======================================================================  * / 

//  Take  an  IRIG  FI  time  packet  and  decode  it  into  something  we  can  use 

EnI106Status  I106_CALL_DECL 

enI106_Decode_TimeFl (SuI106Chl0Header  *  psuHeader, 

void  *  pvBuff, 

SuIrigl06Time  *  psuTime) 

{ 

//  time_t  ITime; 

struct  tm  suTmTime; 

//  struct  timeval  suTvTime; 

SuTimeFl_ChanSpec  *  psuChanSpecTime; 

SuTime_MsgDmyFmt  *  psuTimeDmy; 

SuTime_MsgDayFmt  *  psuTimeDay; 

psuChanSpecTime  =  (SuTimeFl_ChanSpec  *)pvBuff; 

//  Time  in  Day  format 

//  HMMMMM. . . .  THIS  ISN'T  QUITE  RIGHT.  DID  THE  STANDARD  CHANGE??? 
if  (psuChanSpecTime->uDateFmt  ==  0) 

{ 

/ /  Make 

psuTimeDay  =  ( SuTime_MsgDayFmt  *) ((char  *)pvBuff  +  sizeof (SuTimeFl_ChanSpec) ) ; 
suTmTime . tm_sec  =  psuTimeDay->uTSn  *  10  +  psuTimeDay->uSn; 

suTmTime . tm_min  =  psuTimeDay->uTMn  *  10  +  psuTimeDay->uMn; 

suTmTime . tm_hour  =  psuTimeDay->uTHn  *  10  +  psuTimeDay->uHn; 

suTmTime . tm_yday  =  psuTimeDay->uHDn  *  100  +  psuTimeDay->uTDn  *  10  + 

psuTimeDay->uDn  -  1; 

suTmTime . tm_mday  =  suDoy2DmNormal [suTmTime . tm_yday] . iDay; 
suTmTime . tm_mon  =  suDoy2DmNormal [suTmTime . tm_yday] . iMonth; 
suTmTime . tm_year  =  70;  //  i.e.,  1970 

suTmTime . tm_isdst  =  0; 

psuTime->ulSecs  =  mkgmtime (&suTmTime) ; 

psuTime->ulFrac  =  psuTimeDay->uHmn  *  1000000L  +  psuTimeDay->uTmn  *  100000L; 
psuTime->enFmt  =  I106_DATEFMT_DAY; 

} 

//  Time  in  DMY  format 
else 

{ 

psuTimeDmy  =  ( SuTime_MsgDmyFmt  *) ((char  *)pvBuff  +  sizeof (SuTimeFl_ChanSpec) ) ; 

suTmTime . tm_sec  =  psuTimeDmy->uTSn  *  10  +  psuTimeDmy->uSn ; 

suTmTime . tm_min  =  psuTimeDmy->uTMn  *  10  +  psuTimeDmy->uMn ; 

suTmTime . tm_hour  =  psuTimeDmy->uTHn  *  10  +  psuTimeDmy->uHn ; 

suTmTime . tm_yday  =  0; 

suTmTime . tm_mday  =  psuTimeDmy->uTDn  *  10  +  psuTimeDmy->uDn ; 

suTmTime . tm_mon  =  psuTimeDmy->uTOn  *  10  +  psuTimeDmy->uOn  -  1; 

suTmTime . tm_year  =  psuTimeDmy->uOYn  *  1000  +  psuTimeDmy->uHYn  *  100  + 
psuTimeDmy->uTYn  *  10  +  psuTimeDmy->uYn  -  1900; 

suTmTime . tm_isdst  =  0; 

psuTime->ulSecs  =  mkgmtime (SsuTmTime) ; 

psuTime->ulFrac  =  psuTimeDmy->uHmn  *  1000000L  +  psuTimeDmy->uTmn  *  100000L; 
psuTime->enFmt  =  I106_DATEFMT_DMY; 

} 

return  I106_OK; 

} 
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/* 


This  function  returns  the  day  of  the  year  that  corresponds  to  the  date  in 
the  input  parameter  dt . 


-  */ 

/* 

static  int  iDay_Of_Year ( struct  date  *ptDate) 

{ 

int  *paiLastDayOfMonth; 

/ /  Figure  out  leap  year 

if  ( (ptDate->da_year  %  4)  !=  0)  paiLastDayOfMonth  =  aiLastDayOfMonthNormal ; 

else  paiLastDayOfMonth  =  aiLastDayOfMonthLeapYear 

return  paiLastDayOfMonth [ptDate->da_mon-l ]  +  ptDate->da_day ; 


} 

*/ 


EnI106Status  1106  CALL  DECL 


enI106_Encode_TimeFl (SuI106Chl0Header 

unsigned  int 
unsigned  int 
unsigned  int 
SuIrigl06Time 
void 

{ 

//A  temporary  integer  to  decimate  to 
uint32_t  ulntDec; 

struct  tm  *  psuTmTime; 


*  psuHeader, 
uTimeSrc, 
uFmtTime , 
uFmtDate, 

*  psuTime, 

*  pvBuf f TimeFl ) 

get  BCD  factors 


typedef  struct 

{ 

SuTimeFl_ChanSpec  suChanSpec; 
union 
{ 

SuTime_MsgDayFmt  suDayFmt; 
SuTime_MsgDmyFmt  suDmyFmt; 
}  suMsg; 

}  SuMsgTimeFl; 


SuMsgTimeFl  *  psuTimeFl; 


SuTime_MsgDayFmt  *  psuDayFmt; 

SuTime_MsgDmyFmt  *  psuDmyFmt; 

//  Now,  after  creating  this  ubertime-structure  above,  create  a 
//  couple  of  pointers  to  make  the  code  below  simpler  to  read. 
psuTimeFl  =  (SuMsgTimeFl  *) pvBuf fTimeFl ; 
psuDayFmt  =  & (psuTimeFl->suMsg . suDayFmt) ; 
psuDmyFmt  =  & (psuTimeFl->suMsg . suDmyFmt) ; 

//  Zero  out  all  the  time  fields 

memset (psuTimeFl ,  0,  sizeof (SuTimeFl_ChanSpec) ) ; 

//  Break  time  down  to  DMY  HMS 

psuTmTime  =  gmtime ( ( time_t  * ) & (psuTime->ulSecs) ) ; 
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//  Make  channel  specific  data  word 
psuTimeFl->suChanSpec . uTimeSrc  =  uTimeSrc; 

psuTimeFl->suChanSpec . uTimeFmt  =  uFmtTime; 

psuTimeFl->suChanSpec . uDateFmt  =  uFmtDate; 

if  (psuTmTime->tm_year  %  4  ==  0) 

psuTimeFl->suChanSpec . bLeapYear  =  1; 

else 

psuTimeFl->suChanSpec . bLeapYear  =  0; 

//  Fill  in  day  of  year  format 
if  (uFmtDate  ==  0) 

{ 

//  Zero  out  all  the  time  fields 

memset (psuDayFmt,  0,  sizeof ( SuTime_MsgDayFmt) ) ; 

//  Set  the  various  time  fields 
ulntDec  =  psuTime->ulFrac  /  100000L; 
psuDayFmt->uTmn  =  (uintl6_t) (ulntDec  %  10); 
ulntDec  =  (ulntDec  -  psuDayFmt->uHmn)  /  10; 
psuDayFmt->uHmn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_sec; 

psuDayFmt->uSn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDayFmt->uSn)  /  10; 
psuDayFmt->uTSn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_min; 

psuDayFmt->uMn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDayFmt->uMn)  /  10; 
psuDayFmt->uTMn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_hour ; 
psuDayFmt->uHn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDayFmt->uHn)  /  10; 
psuDayFmt->uTHn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_yday  +  1; 
psuDayFmt->uDn  =  (uintl6_t)  (ulntDec  %  10)  ; 
ulntDec  =  (ulntDec  -  psuDayFmt->uDn)  /  10; 
psuDayFmt->uTDn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDayFmt->uTDn)  /  10; 
psuDayFmt->uHDn  =  (uintl6_t) (ulntDec  %  10) ; 

//  Set  the  data  length  in  the  header 
psuHeader->ulDataLen  = 

sizeof (SuTimeFl_ChanSpec)  +  sizeof ( SuTime_MsgDayFmt ) ; 

} 

//  Fill  in  day,  month,  year  format 
else 

{ 

//  Zero  out  all  the  time  fields 

memset (psuDmyFmt,  0,  sizeof ( SuTime_MsgDmyFmt) ) ; 

//  Set  the  various  time  fields 
ulntDec  =  psuTime->ulFrac  /  100000L; 
psuDmyFmt->uTmn  =  (uintl6_t) (ulntDec  %  10); 
ulntDec  =  (ulntDec  -  psuDmyFmt->uHmn)  /  10; 
psuDmyFmt->uHmn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_sec; 

psuDmyFmt->uSn  =  (uintl6_t) (ulntDec  %  10); 
ulntDec  =  (ulntDec  -  psuDmyFmt->uSn)  /  10; 
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psuDmyFmt->uTSn  =  (uintl6_t)  (ulntDec  %  10); 
ulntDec  =  psuTmTime->tm_min; 

psuDmyFmt->uMn  =  (uintl6_t)  (ulntDec  %  10); 
ulntDec  =  (ulntDec  -  psuDmyFmt->uMn)  /  10; 
psuDmyFmt->uTMn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_hour ; 
psuDmyFmt->uHn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDmyFmt->uHn)  /  10; 
psuDmyFmt->uTHn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_mday ; 
psuDmyFmt->uDn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDmyFmt->uDn)  /  10; 
psuDmyFmt->uTDn  =  (uintl6_t)  (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_mon  +  1; 
psuDmyFmt->uOn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDmyFmt->uOn)  /  10; 
psuDmyFmt->uTOn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  psuTmTime->tm_year  +  1900; 
psuDmyFmt->uYn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDmyFmt->uYn)  /  10; 
psuDmyFmt->uTYn  =  (uintl6_t)  (ulntDec  %  10); 
ulntDec  =  (ulntDec  -  psuDmyFmt->uTYn)  /  10; 
psuDmyFmt->uHYn  =  (uintl6_t) (ulntDec  %  10); 

ulntDec  =  (ulntDec  -  psuDmyFmt->uHYn)  /  10; 
psuDmyFmt->uOYn  =  (uintl6_t) (ulntDec  %  10); 

//  Set  the  data  length  in  the  header 
psuHeader->ulDataLen  = 

sizeof (SuTimeFl_ChanSpec)  t  sizeof (SuTime_MsgDmyFmt) ; 

} 


//  Make  the  data  buffer  checksum  and  update  the  header 
uAddDataFillerChecksum (psuHeader ,  (unsigned  char  *)pvBuffTimeFl); 

return  I106_OK; 

} 
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Appendix  A-7.  il06_decode_tmats.h 

/**************************************************************************** 
il06_decode_tmats .h  - 
Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#ifndef  _I106_DECODE_TMATS_H 
#def ine  _I106_DECODE_TMATS_H 

#ifdef  _ cplusplus 

extern  "C"  { 

#endif 

/* 

*  Macros  and  definitions 

*  _ 

*/ 


/* 

*  Data  structures 

*  _ 

*/ 

//  Channel  specific  data  word 
// - 

#if  defined (_MSC_VER) 

#pragma  pack (push) 

#pragma  pack(l) 

#endif 
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typedef  PUBLIC  struct  Tmats_ChanSpec_S 
{ 


#if 


#else 

}  _ attribute _  ((packed))  SuTmats_ChanSpec; 

#endif 


uint32  t 

iChl OVer 

:  8; 

// 

Recorder 

Ch  10  Version 

uint32  t 

bConf igChange 

:  1; 

// 

Recorder 

configuration 

uint32  t 

iReserved 

:  23; 

// 

Reserved 

! defined ( 

_ GNUC _ ) 

}  SuTmats 

ChanSpec; 

#if  defined (_MSC_VER) 
#pragma  pack (pop) 
#endif 


//  B  Records 
// - 

typedef  PUBLIC  struct  SuBRecord_S 
{ 


int 

iRecordNum; 

// 

B-x 

char 

*  szDataLinkName; 

// 

B-x\DLN 

int 

iNumBuses ; 

// 

B-x\NBS\N 

struct  SuBRecord  S 

*  psuNextBRecord; 

}  SuBRecord; 

//  M  Records 
// - 

typedef  PUBLIC  struct  SuMRecord_S 
{ 


int 

iRecordNum; 

// 

M-x 

char 

*  szDataSourcelD; 

// 

M-x\ ID 

char 

*  szDataLinkName; 

// 

M-x\BB\DLN 

char 

*  szBasebandSignalType; 

// 

M-x\BSGl 

struct 

SuBRecord  S 

*  psuBRecord; 

// 

Corresponding  B  record 

struct 

SuMRecord  S 

*  psuNextMRecord; 

// 

Used  to  keep  track  of  M 

records 

}  SuMRecord; 


//  R  Records 
// - 

//  R  record  data  source 
typedef  PUBLIC  struct  SuRDataSource__S 
{ 


int 

iDataSourceNum; 

// 

R-x\XXX-n 

char 

* 

szDataSourcelD; 

// 

R-x\DSI-n 

char 

* 

szChannelDataType ; 

// 

R-x\CDT-n 

int 

iTrackNumber ; 

// 

R-x\TKl-n 

int 

bEnabled; 

// 

R-x\CHE-n 

struct 

SuMRecord  S 

* 

psuMRecord; 

// 

Corresponding  M  record 

struct 

SuRDataSource  S 

-k 

psuNextRDataSource; 

}  SuRDataSource; 

//  R  record 

typedef  PUBLIC  struct  SuRRecord_S 

{ 

int  iRecordNum;  //  R-x 
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char 

*  szDataSourcelD; 

// 

R-x\ ID 

int 

iNumDataSources ; 

// 

R-x\N 

SuRDataSource 

*  psuFirstDataSource; 

// 

struct  SuRRecord  S 

*  psuNextRRecord; 

// 

Used  to  keep  track  of  R 

records 

}  SuRRecord; 


//  G  Records 
// - 

//  G  record,  data  source 
typedef  PUBLIC  struct  SuGDataSource_S 
{ 


int 

iDataSourceNum; 

// 

G\XXX-n 

char 

* 

szDataSourcelD; 

// 

G\DSI-n 

char 

* 

szDataSourceType; 

// 

G\DST-n 

struct  SuRRecord  S 

* 

psuRRecord; 

// 

Corresponding 

struct  SuGDataSource  S 

* 

psuNextGDataSource; 

}  SuGDataSource; 

//  G  record 

typedef  PUBLIC  struct  GRecord 

r 

_s 

l 

char 

* 

szProgramName; 

// 

G\PN 

char 

* 

szIrigl06Rev; 

// 

G\106 

int 

iNumDataSources ; 

// 

G\ DS I \N 

SuGDataSource 

* 

psuFirstGDataSource; 

}  SuGRecord; 

//  Memory  linked  list 
// - 

//  Linked  list  that  keeps  track  of  malloc'ed  memory 
typedef  PUBLIC  struct  MemBlock_S 
{ 

void  *  pvMemBlock; 

struct  MemBlock_S  *  psuNextMemBlock; 

}  SuMemBlock; 

//  Decoded  TMATS  info 
// - 

typedef  PUBLIC  struct  SuTmatsInf o_S 
{ 


int 

iChlOVer; 

int 

bConfigChange; 

SuGRecord 

* 

psuFirstGRecord; 

SuRRecord 

* 

psuFirstRRecord; 

SuMRecord 

* 

psuFirstMRecord; 

SuBRecord 

* 

psuFirstBRecord; 

void 

* 

psuFirstTRecord; 

void 

* 

psuFirstPRecord; 

void 

' k 

psuFirstDRecord; 

void 

* 

psuFirstSRecord; 

void 

* 

psuFirstARecord; 

void 

* 

psuFirstCRecord; 

void 

* 

psuFirstHRecord; 

void 

* 

psuFirstVRecord; 

SuMemBlock 

* 

psuFirstMemBlock 

}  SuTmatsInfo; 

/* 
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*  Function  Declaration 


*/ 

EnI106Status  I106_CALL_DECL 

en 1 1 0 6_Decode_Tmat  s ( Su 1 1 0  6 Chi 0 Header 
void 

SuTmatsInf o 


void  110  6_CALL_DECL 

enll 06_Free_TmatsInf o ( SuTmatsInf o 

I106_CALL_DECL  EnI106Status 

enI106_Encode_Tmats (SuI106Chl0Header 
void 
char 


#ifdef  _ cplusplus 

} 

#endif 

#endif 


psuHeader, 
pvBuf f , 

psuTmatsInfo) ; 


psuTmatsInfo) ; 


psuHeader, 
pvBuf f, 
SzTMATS) ; 
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Appendix  A-8.  il06_decode_tmats.c 

il06_decode_tmats . c  - 
Copyright  (c)  2005  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 


*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 


#include 

#include 

#include 

#include 

#include 


<stdio . h> 
<stdlib . h> 
<string . h> 
<malloc . h> 
<assert . h> 


#include  "config.h" 
#include  "stdint.h" 


#include  "irigl06chl0 . h" 
#include  "il06  decode  tmats.h" 


y****************************************************************************** 
Here's  how  this  module  decodes  and  stores  TMATS  data. 

Any  field  that  is  to  be  decoded  and  stored  must  have  a  corresponding  entry 
in  one  of  the  defined  data  structures.  In  other  words,  there  is  no  support 
for  storing  and  later  retrieving  arbitrary  TMATS  lines.  Maybe  that  would  have 
been  better,  but  for  now  only  TMATS  lines  that  are  understood  by  this  module 
will  be  stored. 

This  module  makes  no  assumptions  about  the  ordering,  numbering,  or 
numbers  of  TMATS  lines.  Information  is  stored  in  linked  lists  that  are 
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created  and  grow  as  needed.  For  now  there  is  the  assumption  that  there 
is  only  one  G  record,  but  there  may  be  multiples  of  other  records. 

There  is  a  linked  list  for  each  type  of  record  (except  the  one  and  only 
G  record) .  As  the  TMATS  lines  are  read  one  by  one,  the  info  is  decoded 
and  stored  in  the  appropriate  existing  record,  or  a  new  record  is  create 
if  necessary. 

After  all  TMATS  lines  are  read  and  decoded,  the  linked  lists  are  scanned 
and  connected  into  a  tree.  That  is,  R  records  are  connected  to  the 
corresponding  G,  M  records  are  connected  to  the  corresponding  R,  etc. 

When  done,  the  TMATS  info  is  organized  into  a  tree  similar  to  that  depicted 
in  IRIG  106  Chapter  9  (TMATS)  Figure  9-1  "Group  relationships". 

There  are  at  least  two  ways  to  use  this  information.  One  is  to  start  with 
the  top  level  G  record  and  walk  the  tree.  This  is  a  good  way  to  provide 
access  to  all  the  decoded  data,  for  example,  to  print  out  everything  in 
the  tree.  The  other  way  to  access  data  is  to  start  at  the  beginning  of 
one  of  the  linked  lists  of  records,  and  walk  the  linked  list.  This  might 
be  a  good  way  to  get  just  some  specific  data,  like  a  list  of  Channel  ID's 
for  1553IN  type  data  sources. 

******************************************************************************/ 


/* 

*  Macros  and  definitions 


*/ 

#define  CR  (13) 

fdefine  LF  (10) 

/* 

*  Data  structures 


*/ 


//  1553  bus  attributes 
// - 

/* 

*  Module  data 


*/ 


//  This  is  an  empty  string  that  text  fields  can  point  to  before 
//  they  get  a  value.  This  ensures  that  if  fields  don't  get  set  while 
//  reading  the  TMATS  record  they  will  point  to  something  benign, 
char  m_szEmpty[]  = 

static  SuTmatsInfo  *  m_psuTmatsInfo; 

/* 

*  Function  Declaration 


*/ 


int  bDecodeGLine (char  * 
int  bDecodeRLine (char  * 
int  bDecodeMLine  (char  * 
int  bDecodeBLine (char  * 


szCodeName, 

char 

~k 

szDataltem, 

SuGRecord 

*  k 

szCodeName, 

char 

: k 

szDataltem, 

SuRRecord 

: k  -k 

szCodeName, 

char 

~k 

szDataltem, 

SuMRecord 

~k  ~k 

szCodeName, 

char 

* 

szDataltem, 

SuBRecord 

k  -k 

ppsuFirstGRec) 

ppsuFirstRRec) 

ppsuFirstMRec) 

ppsuFirstBRec) 
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SuRRecord  *  psuGetRRecord ( SuRRecord  **  ppsuFirstRRec,  int  iRIndex,  int  bMakeNew); 

SuMRecord  *  psuGetMRecord ( SuMRecord  **  ppsuFirstMRec,  int  iRIndex,  int  bMakeNew); 

SuBRecord  *  psuGetBRecord ( SuBRecord  **  ppsuFirstBRec,  int  iRIndex,  int  bMakeNew); 

SuGDataSource  *  psuGetGDataSource ( SuGRecord  *  psuGRec,  int  iDSIIndex,  int  bMakeNew) 
SuRDataSource  *  psuGetRDataSource ( SuRRecord  *  psuRRec,  int  iDSIIndex,  int  bMakeNew) 

void  vConnectRtoG ( SuGRecord  *  psuFir stGRecord,  SuRRecord  *  psuFir stRRecord) ; 
void  vConnectMtoR ( SuRRecord  *  psuFir stRRecord,  SuMRecord  *  psuFir stMRecord) ; 
void  vConnectBtoM ( SuMRecord  *  psuFir stMRecord,  SuBRecord  *  psuFir stBRecord) ; 

void  *  TmatsMalloc ( size_t  iSize) ; 

/ *  =======================================================================  * / 

/*  The  idea  behind  this  routine  is  to  read  the  TMATS  record,  parse  it,  and 

*  put  the  various  data  fields  into  a  tree  structure  that  can  be  used  later 

*  to  find  various  settings. 

*/ 


EnI106Status  I106_CALL_DECL 

enI106_Decode_Tmats (SuI106Chl0Header  *  psuHeader, 


void  *  pvBuff, 

SuTmatsInfo  *  psuTmatsInfo) 

i 

unsigned  long 

ilnBuf f Idx; 

char 

* 

achlnBuff; 

char 

szLine [2048] ; 

int 

iLineldx; 

char 

* 

szCodeName ; 

char 

* 

szDataltem; 

int 

bParseError  ; 

SuTmats  ChanSpec 

* 

psuTmats  ChanSpec; 

//  Store  a  copy 

for 

module  wide  use 

m  psuTmatsInfo  = 

psuTmatsInfo; 

//  Initialize  the  TMATS  info  data  structure 
enI106_Free_TmatsInfo (psuTmatsInfo) ; 

//  Decode  any  available  info  from  channel  specific  data  word 
switch  (psuHeader->ubyHdrVer ) 


case  0x03  :  //  106-07 

psuTmats  ChanSpec  =  (SuTmats  ChanSpec  *)pvBuff; 


psuTmatsInfo->iChl OVer 
psuTmatsInfo->bConf igChange 
break; 
default  : 

psuTmats In fo->iChl OVer 
psuTmatsInfo->bConf igChange 
break; 


=  psuTmats_ChanSpec->iChl OVer ; 

=  psuTmats_ChanSpec->bConf igChange; 


=  0x00; 
=  0x00; 


//  Initialize  the  first  (and  only,  for  now)  G  record 

psuTmatsInfo->psuFirstGRecord  =  (SuGRecord  *) TmatsMalloc ( sizeof (SuGRecord) ) ; 
psuTmatsInfo->psuFirstGRecord->szProgramName  =  m_szEmpty; 

psuTmatsInfo->psuFirstGRecord->szIrigl06Rev  =  m_szEmpty; 

psuTmatsInfo->psuFirstGRecord->iNumDataSources  =  0; 

psuTmats!nfo->psuFirstGRecord->psuFirstGDataSource  =  NULL; 


//  Buffer  starts  past  Channel  Specific  Data 
achlnBuff  =  (char  *)pvBuff; 
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ilnBuffldx  =  4; 

//  Loop  until  we  get  to  the  end  of  the  buffer 
while  (bTRUE) 

{ 


//  If  at  the  end  of  the  buffer  then  break  out  of  the  big  loop 
if  (ilnBuffldx  >=  psuHeader->ulDataLen) 
break; 

//  Fill  a  local  buffer  with  one  line 
// - 

//  Initialize  input  line  buffer 
szLine [0]  =  ' \0 ' ; 
iLineldx  =  0; 

//  Read  from  buffer  until  complete  line 
while  (bTRUE) 

{ 

//  If  at  the  end  of  the  buffer  then  break  out 
if  (ilnBuffldx  >=  psuHeader->ulDataLen) 
break; 

//  If  line  terminator  and  line  buffer  not  empty  then  break  out 
if  ( (achlnBuff [ilnBuffldx]  ==  CR)  I | 

(achlnBuff [ilnBuffldx]  ==  LF) ) 

{ 

if  ( strlen  ( szLine)  !=  0) 
break; 

}  //  end  if  line  terminator 

//  Else  copy  next  character  to  line  buffer 
else 


szLine [ iLineldx]  =  achlnBuff [ilnBuffldx]  ; 
if  (iLineldx  <  2048) 
iLineIdx++  ; 

szLine [ iLineldx]  =  ' \ 0  ' ; 

} 


//  Next  character  from  buffer 
ilnBuf fldx++; 

}  //  end  while  filling  complete  line 

//  Decode  the  TMATS  line 
// - 

//  Go  ahead  and  split  the  line  into  left  hand  and  right  hand  sides 
szCodeName  =  strtok ( szLine,  ":"); 
szDataltem  =  strtok(NULL,  ";"); 

//  If  errors  tokenizing  the  line  then  skip  over  them 
if  ( (szCodeName  ==  NULL)  | |  (szDataltem  ==  NULL) ) 
continue ; 

//  Determine  and  decode  different  TMATS  types 
switch  (szCodeName [0] ) 

{ 

case  'G'  :  //  General  Information 

bParseError  =  bDecodeGLine (szCodeName, 

szDataltem, 
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SpsuTmatsInf o->psuFirstGRecord)  ; 

break; 

case  'B'  ;  //  Bus  Data  Attributes 

bParseError  =  bDecodeBLine (szCodeName, 

szDataltem, 

SpsuTmatsInf o->psuFirstBRecord)  ; 

break; 

case  'R'  :  //  Tape/Storage  Source  Attributes 
bParseError  =  bDecodeRLine (szCodeName, 

szDataltem, 

SpsuTmatsInf o->psuFirstRRecord)  ; 

break; 

case  'T'  ;  //  Transmission  Attributes 

break; 

case  'M'  ;  //  Multiplexing/Modulation  Attributes 

bParseError  =  bDecodeMLine (szCodeName, 

szDataltem, 

SpsuTmatsInf o->psuFirstMRecord) ; 

break; 

case  'P'  ;  //  PCM  Format  Attributes 
break; 

case  'D'  ;  //  PCM  Measurement  Description 

break; 

case  'S'  :  //  Packet  Format  Attributes 
break; 

case  'A'  :  //  PAM  Attributes 

break; 

case  'C'  :  //  Data  Conversion  Attributes 

break; 

case  'H'  :  //  Airborne  Hardware  Attributes 
break; 

case  'V'  :  //  Vendor  Specific  Attributes 

break; 

default  ; 
break; 

}  //  end  decoding  switch 

}  //  end  looping  forever  on  reading  TMATS  buffer 
//  Now  link  the  various  records  together  into  a  tree 

vConnectRtoG (psuTmatsInf o->psuFirstGRecord,  psuTmatsInf o->psuFirstRRecord) ; 
vConnectMtoR (psuTmatsInf o->psuFirstRRecord,  psuTmatsInf o->psuFirstMRecord) ; 
vConnectBtoM (psuTmatsInf o->psuFirstMRecord,  psuTmatsInf o->psuFirstBRecord) ; 


m_psuTmats!nfo  =  NULL; 


return  I106_OK; 

} 
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/* - 

*  G  Records 


int  bDecodeGLine (char  *  szCodeName,  char  *  szDataltem,  SuGRecord  **  ppsuGRecord) 

{ 

char  *  szCodeField; 

int  iTokens; 

int  iDSIIndex; 

SuGRecord  *  psuGRec; 

SuGDataSource  *  psuDataSource; 

//  See  which  G  field  it  is 
szCodeField  =  strtok (szCodeName,  "\\") ; 
assert ( szCodeField [ 0 ]  ==  ' G ' )  ; 

//  Get  the  G  record 
psuGRec  =  *ppsuGRecord; 

szCodeField  =  strtok (NULL,  "\\")  ; 

/ /  PN  -  Program  Name 

if  (strcasecmp (szCodeField,  "PN")  ==  0) 

{ 

psuGRec->szProgramName  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuGRec->szProgramName  !=  NULL); 
strcpy (psuGRec->szProgramName,  szDataltem) ; 

} 

//  106  -  IRIG  106  rev  level 

else  if  (strcasecmp (szCodeField,  "106")  ==  0) 

{ 

psuGRec->szIrigl06Rev  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert  (psuGRec->szIrigl06Rev  !=  NULL); 
strcpy (psuGRec->szIrigl06Rev,  szDataltem) ; 

}  //  end  if  106 

//  DSI  -  Data  source  identifier  info 

else  if  (strcasecmp (szCodeField,  "DSI")  ==  0) 

{ 

szCodeField  =  strtok(NULL,  "\\") ; 

//  N  -  Number  of  data  sources 
if  (strcasecmp (szCodeField,  "N")  ==  0) 

psuGRec->iNumDataSources  =  atoi ( szDataltem) ; 

}  //  end  if  DSI 

//  DSI-n  -  Data  source  identifiers 

else  if  (strncasecmp (szCodeField,  "DSI-",4)  ==  0) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex) ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetGDataSource (psuGRec,  iDSIIndex,  bTRUE) ; 
assert (psuDataSource  !=  NULL) ; 

psuDataSource->szDataSourceID  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuDataSource->szDataSourceID  !=  NULL) ; 
strcpy (psuDataSource->szDataSourceID,  szDataltem) ; 

}  //  end  if  DSI  Index  found 
}  //  end  if  DSI-n 

//  DST-n  -  Data  source  type 
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else  if  (strncasecmp (szCodeField,  "DST-",4)  ==  0) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex) ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetGDataSource (psuGRec,  iDSIIndex,  bTRUE); 
assert  (psuDataSource  !=  NULL); 
psuDataSource->szDataSourceType  =  (char 
* ) TmatsMalloc ( strlen ( szDatal tem) +1 ) ; 

assert  (psuDataSource->szDataSourceType  !=  NULL); 
strcpy (psuDataSource->szDataSourceType,  szDataltem) ; 

}  //  end  if  DSI  Index  found 
}  //  end  if  DST-n 


return  0; 

} 


/*  -  */ 

//  Return  the  G  record  Data  Source  record  with  the  given  index  or 
//  make  a  new  one  if  necessary. 

SuGDataSource  *  psuGetGDataSource ( SuGRecord  *  psuGRecord,  int  iDSIIndex,  int  bMakeNew) 

{ 

SuGDataSource  **ppsuDataSrc  =  & (psuGRecord- >psuFirstGDataSource) ; 

//  Walk  the  linked  list  of  data  sources,  looking  for  a  match  or 
//  the  end  of  the  list 
while  (bTRUE) 

{ 

//  If  record  pointer  in  linked  list  is  null  then  exit 
if  ( *ppsuDataSrc  ==  NULL) 

{ 

break; 

} 

//  If  the  data  source  number  matched  then  record  found,  exit 
if  ( ( *ppsuDataSrc) ->iDataSourceNum  ==  iDSIIndex) 

{ 

break; 

} 


//  Not  found  but  next  record  exists  so  make  it  our  current  pointer 
ppsuDataSrc  =  & (  ( *ppsuDataSrc) ->psuNextGDataSource) ; 

}  //  end 


//  If  no  record  found  then  put  a  new  one  on  the  end  of  the  list 
if  ( ( *ppsuDataSrc  ==  NULL)  &&  (bMakeNew  ==  bTRUE) ) 

{ 

//  Allocate  memory  for  the  new  record 

*ppsuDataSrc  =  (SuGDataSource  *) TmatsMalloc (sizeof (SuGDataSource)  )  ; 
assert  (*ppsuDataSrc  !=  NULL) ; 


//  Now  initialize  some  fields 
(*ppsuDataSrc) ->iDataSourceNum 
(*ppsuDataSrc) ->szDataSourceID 
(*ppsuDataSrc) ->szDataSourceType 
(*ppsuDataSrc) ->psuRRecord 
(*ppsuDataSrc) ->psuNextGDataSource 
} 


iDSIIndex; 
m_s z Empty ; 
m_s z Empty  ; 
NULL  ; 

NULL  ; 


return  *ppsuDataSrc; 
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} 


/* - 

*  R  Records 


*/ 


int 


bDecodeRLine (char  *  szCodeName, 

{ 


char 

int 

int 

int 

SuRRecord 

SuRDataSource 


*  szCodeField; 
iTokens ; 
iRIdx; 

iDSI Index; 

*  psuRRec; 

*  psuDataSource; 


char  *  szDataltem,  SuRRecord  **  ppsuFir stRRecord) 


//  See  which  R  field  it  is 
szCodeField  =  strtok (szCodeName,  "\\") ; 
assert ( szCodeField [ 0 ]  ==  'R'); 


/ /  Get  the  R  record  index  number 

iTokens  =  sscanf (szCodeField,  "%*lc-%i",  SiRIdx) ; 
if  (iTokens  ==  1) 

{ 

psuRRec  =  psuGetRRecord (ppsuFirstRRecord,  iRIdx,  bTRUE); 
assert (psuRRec  !=  NULL); 


else 

return  1; 

szCodeField  =  strtok (NULL,  "\\") ; 

//ID  -  Data  source  ID 

if  (strcasecmp (szCodeField,  "ID")  ==  0) 

{ 

psuRRec->szDataSourceID  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuRRec->szDataSourceID  !=  NULL) ; 
strcpy (psuRRec->szDataSourceID,  szDataltem) ; 

}  //  end  if  N 

//  N  -  Number  of  data  sources 

else  if  (strcasecmp (szCodeField,  "N")  ==  0) 

{ 

psuRRec->iNumDataSources  =  atoi ( szDataltem) ; 

}  //  end  if  N 

//  DSI-n  -  Data  source  identifier 

else  if  (strncasecmp (szCodeField,  "DSI-",4)  ==  0) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex) ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetRDataSource (psuRRec,  iDSIIndex,  bTRUE); 
assert (psuDataSource  !=  NULL) ; 

psuDataSource->szDataSourceID  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) 
assert (psuDataSource->szDataSourceID  !=  NULL) ; 
strcpy (psuDataSource->szDataSourceID,  szDataltem) ; 

}  //  end  if  DSI  Index  found 

else 

return  1; 

}  //  end  if  DSI-n 
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//  CDT-n/DST-n  -  Channel  data  type 

//A  certain  vendor  who  will  remain  nameless  (mainly  because  I  don't 
//  know  which  one)  encodes  the  channel  data  type  as  a  Data  Source 
//  Type.  This  appears  to  be  incorrect  according  to  the  Chapter  9 
//  spec  but  can  be  readily  found  in  Chapter  10  data  files, 
else  if  (  ( strncasecmp ( szCodeField,  "CDT-",4)  ==  0)  || 

( strncasecmp ( szCodeField,  "DST-",4)  ==  0)) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex) ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetRDataSource (psuRRec,  iDSIIndex,  bTRUE); 
assert  (psuDataSource  !=  NULL); 
psuDataSource->szChannelDataType  =  (char 
* ) TmatsMalloc ( strlen ( szDatal tem) +1 )  ; 

assert  (psuDataSource->szChannelDataType  !=  NULL); 
strcpy (psuDataSource->szChannelDataType,  szDataltem) ; 

}  //  end  if  DSI  Index  found 

else 

return  1; 

}  //  end  if  DST-n 

//  TKl-n  -  Track  number  /  Channel  number 

else  if  (strncasecmp (szCodeField,  "TKl-",4)  ==  0) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex)  ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetRDataSource (psuRRec,  iDSIIndex,  bTRUE); 
assert  (psuDataSource  !=  NULL); 

psuDataSource->iTrackNumber  =  atoi ( szDataltem) ; 

}  //  end  if  DSI  Index  found 

else 

return  1; 

}  //  end  if  TKl-n 

//  CHE-n  -  Channel  Enabled 

else  if  (strncasecmp (szCodeField,  "CHE-",4)  ==  0) 

{ 

iTokens  =  sscanf (szCodeField,  "%*3c-%i",  SiDSIIndex)  ; 
if  (iTokens  ==  1) 

{ 

psuDataSource  =  psuGetRDataSource (psuRRec,  iDSIIndex,  bTRUE); 
assert  (psuDataSource  !=  NULL); 

psuDataSource->bEnabled  =  (strncasecmp (szDataltem,  "T", 1)  ==  0)  ; 
}  //  end  if  DSI  Index  found 

else 

return  1; 

}  //  end  if  CHE-n 


return  0; 

} 


/*  -  */ 

SuRRecord  *  psuGetRRecord ( SuRRecord  **  ppsuFirstRRecord,  int  iRIndex,  int  bMakeNew) 

{ 

SuRRecord  **  ppsuCurrRRec  =  ppsuFirstRRecord; 

//  Loop  looking  for  matching  index  number  or  end  of  list 
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while  (bTRUE) 

{ 

//  Check  for  end  of  list 
if  ( *ppsuCurrRRec  ==  NULL) 
break; 

//  Check  for  matching  index  number 
if  ( (*ppsuCurrRRec) ->iRecordNum  ==  iRIndex) 
break; 

//  Move  on  to  the  next  record  in  the  list 
ppsuCurrRRec  =  &  (  ( *ppsuCurrRRec) ->psuNextRRecord) ; 
} 


//  If  no  record  found  then  put  a  new  one  on  the  end  of  the  list 
if  ( ( *ppsuCurrRRec  ==  NULL)  &&  (bMakeNew  ==  bTRUE) ) 

{ 

//  Allocate  memory  for  the  new  record 

*ppsuCurrRRec  =  (SuRRecord  * ) TmatsMalloc ( sizeof (SuRRecord) ) ; 
assert  (*ppsuCurrRRec  !=  NULL) ; 


//  Now  initialize  some  fields 
( *ppsuCurrRRec ) ->iRecordNum 
( *ppsuCurrRRec ) ->szDataSourceID 
( * ppsuCurrRRec ) ->iNumDataSources 
( * ppsuCurrRRec )->psuFirstDataSource 
( *ppsuCurrRRec ) ->psuNextRRecord 
} 


iRIndex; 
m_s z Empty; 
0  ; 

NULL; 

NULL; 


return  *ppsuCurrRRec ; 

} 


/*  -  */ 

//  Return  the  R  record  Data  Source  record  with  the  given  index  or 
//  make  a  new  one  if  necessary. 

SuRDataSource  *  psuGetRDataSource ( SuRRecord  *  psuRRecord,  int  iDSIIndex,  int  bMakeNew) 

{ 

SuRDataSource  **  ppsuDataSrc  =  & (psuRRecord->psuFir stDataSource) ; 

//  Walk  the  linked  list  of  data  sources,  looking  for  a  match  or 
//  the  end  of  the  list 
while  (bTRUE) 

{ 

//  If  record  pointer  in  linked  list  is  null  then  exit 
if  ( *ppsuDataSrc  ==  NULL) 

{ 

break; 

} 

//  If  the  data  source  number  matched  then  record  found,  exit 
if  ( ( *ppsuDataSrc) ->iDataSourceNum  ==  iDSIIndex) 

{ 

break; 

} 

//  Not  found  but  next  record  exists  so  make  it  our  current  pointer 
ppsuDataSrc  =  & ( (*ppsuDataSrc) ->psuNextRDataSource)  ; 

}  //  end 
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//  If  no  record  found  then  put  a  new  one  on  the  end  of  the  list 
if  ( ( *ppsuDataSrc  ==  NULL)  &&  (bMakeNew  ==  bTRUE) ) 

{ 

//  Allocate  memory  for  the  new  record 

*ppsuDataSrc  =  ( SuRDataSource  *) TmatsMalloc (sizeof (SuRDataSource) ) ; 
assert (*ppsuDataSrc  !=  NULL) ; 


//  Now  initialize  some  fields 
(*ppsuDataSrc) ->iDataSourceNum 
(*ppsuDataSrc) ->szDataSourceID 
(*ppsuDataSrc) ->szChannelDataType 
( *ppsuDataSrc) ->iTrackNumber 
(*ppsuDataSrc) ->psuMRecord 
(*ppsuDataSrc) ->psuNextRDataSource 
} 


iDSI Index; 
m_s z Empty ; 
m_s z Empty; 

0  ; 

NULL  ; 

NULL  ; 


return  *ppsuDataSrc; 

} 


/* - 

*  M  Records 


*/ 


int 


bDecodeMLine (char  *  szCodeName, 

{ 


char 

int 

int 

SuMRecord 


*  szCodeField; 
iTokens ; 
iRIdx; 

*  psuMRec; 


char  *  szDataltem,  SuMRecord  **  ppsuFir stMRecord) 


//  See  which  M  field  it  is 
szCodeField  =  strtok (szCodeName,  "\\") ; 
assert ( szCodeField [ 0 ]  ==  'M'); 


/ /  Get  the  M  record  index  number 

iTokens  =  sscanf (szCodeField,  "%*lc-%i",  SiRIdx) ; 
if  (iTokens  ==  1) 

{ 

psuMRec  =  psuGetMRecord (ppsuFirstMRecord,  iRIdx,  bTRUE); 
assert (psuMRec  !=  NULL) ; 


else 

return  1; 

szCodeField  =  strtok (NULL,  "\\") ; 

//ID  -  Data  source  ID 

if  (strcasecmp (szCodeField,  "ID")  ==  0) 

{ 

psuMRec->szDataSourceID  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuMRec->szDataSourceID  !=  NULL) ; 
strcpy (psuMRec->szDataSourceID,  szDataltem) ; 

}  //  end  if  ID 

//  BSG1  -  Baseband  signal  type 

else  if  (strcasecmp (szCodeField,  "BSG1")  ==  0) 

{ 

psuMRec->szBasebandSignalType  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuMRec->szBasebandSignalType  !=  NULL) ; 
strcpy (psuMRec->szBasebandSignalType,  szDataltem) ; 
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}  //  end  if  BSG1 
//  BB\DLN  -  Data  link  name 

else  if  (strncasecmp (szCodeField,  "BB",2)  ==  0) 

{ 

szCodeField  =  strtok (NULL,  "\\")  ; 

//  DLN  -  Data  link  name 

if  (strcasecmp (szCodeField,  "DLN")  ==  0) 

{ 

psuMRec->szDataLinkName  =  (char  * ) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert (psuMRec->szDataLinkName  !=  NULL); 
strcpy (psuMRec->szDataLinkName,  szDataltem) ; 

} 

}  //  end  if  BB\DLN 


return  0; 

} 


/*  -  */ 

SuMRecord  *  psuGetMRecord ( SuMRecord  **  ppsuFirstMRecord,  int  iRIndex,  int  bMakeNew) 

{ 

SuMRecord  **  ppsuCurrMRec  =  ppsuFirstMRecord; 

//  Loop  looking  for  matching  index  number  or  end  of  list 
while  (bTRUE) 

{ 

//  Check  for  end  of  list 
if  ( *ppsuCurrMRec  ==  NULL) 
break; 

//  Check  for  matching  index  number 
if  ( (*ppsuCurrMRec) ->iRecordNum  ==  iRIndex) 
break; 

//  Move  on  to  the  next  record  in  the  list 
ppsuCurrMRec  =  & ( ( *ppsuCurrMRec) ->psuNextMRecord) ; 

} 


//  If  no  record  found  then  put  a  new  one  on  the  end  of  the  list 
if  ( ( *ppsuCurrMRec  ==  NULL)  &&  (bMakeNew  ==  bTRUE) ) 

{ 

//  Allocate  memory  for  the  new  record 

*ppsuCurrMRec  =  (SuMRecord  *) TmatsMalloc ( sizeof (SuMRecord) ) ; 
assert  (*ppsuCurrMRec  !=  NULL); 


//  Now  initialize  some  fields 
( *ppsuCurrMRec ) ->iRecordNum 
( *ppsuCurrMRec ) ->szDataSourceID 
( *ppsuCurrMRec ) ->szDataLinkName 
( * ppsuCurrMRec ) ->szBasebandSignalType 
( *ppsuCurrMRec ) ->psuNextMRecord 
} 


iRIndex; 
m_s z Empty ; 
m_s z Empty  ; 
m_s z Empty ; 
NULL; 


return  *ppsuCurrMRec ; 

} 


/* - 

*  B  Records 
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~k 

*/ 


int 


bDecodeBLine (char  *  szCodeName, 

{ 


char 

int 

int 

SuBRecord 


*  szCodeField; 
iTokens ; 
iRIdx; 

*  psuBRec; 


char  *  szDataltem,  SuBRecord  **  ppsuFir stBRecord) 


//  See  which  B  field  it  is 
szCodeField  =  strtok (szCodeName,  "\\") ; 
assert  ( szCodeField [ 0 ]  ==  'B'); 


/ /  Get  the  B  record  index  number 

iTokens  =  sscanf (szCodeField,  "%*lc-%i",  SiRIdx) ; 
if  (iTokens  ==  1) 

{ 

psuBRec  =  psuGetBRecord (ppsuFirstBRecord,  iRIdx,  bTRUE); 
assert (psuBRec  !=  NULL); 


else 

return  1; 

szCodeField  =  strtok (NULL,  "\\") ; 

//  DLN  -  Data  link  name 

if  (strcasecmp (szCodeField,  "DLN")  ==  0) 

{ 

psuBRec->szDataLinkName  =  (char  *) TmatsMalloc ( strlen ( szDataltem) +1 ) ; 
assert  (psuBRec->szDataLinkName  !=  NULL); 
strcpy (psuBRec->szDataLinkName,  szDataltem) ; 

}  //  end  if  DLN 

//  NBS\N  -  Number  of  buses 

else  if  (strncasecmp (szCodeField,  "NBS",3)  ==  0) 

{ 

szCodeField  =  strtok(NULL,  "\\") ; 

//  N  -  Number  of  channels 
if  (strcasecmp (szCodeField,  "N")  ==  0) 

{ 

psuBRec->iNumBuses  =  atoi ( szDataltem) ; 

} 

}  //  end  if  NBS 

return  0; 

} 


/*  -  */ 

SuBRecord  *  psuGetBRecord ( SuBRecord  **  ppsuFirstBRecord,  int  iRIndex,  int  bMakeNew) 

{ 

SuBRecord  **  ppsuCurrBRec  =  ppsuFirstBRecord; 

//  Loop  looking  for  matching  index  number  or  end  of  list 
while  (bTRUE) 

{ 

//  Check  for  end  of  list 
if  ( *ppsuCurrBRec  ==  NULL) 
break; 
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//  Check  for  matching  index  number 
if  ( (*ppsuCurrBRec) ->iRecordNum  ==  iRIndex) 
break; 

//  Move  on  to  the  next  record  in  the  list 
ppsuCurrBRec  =  &  (  ( *ppsuCurrBRec) ->psuNextBRecord) ; 
} 


//  If  no  record  found  then  put  a  new  one  on  the  end  of  the  list 
if  ( ( *ppsuCurrBRec  ==  NULL)  &&  (bMakeNew  ==  bTRUE) ) 

{ 

//  Allocate  memory  for  the  new  record 

*ppsuCurrBRec  =  (SuBRecord  *) TmatsMalloc ( sizeof (SuBRecord)  )  ; 
assert  (*ppsuCurrBRec  !=  NULL) ; 

//  Now  initialize  some  fields 
(*ppsuCurrBRec) ->iRecordNum 
(*ppsuCurrBRec) ->szDataLinkName 
(*ppsuCurrBRec) ->iNumBuses 
(*ppsuCurrBRec) ->psuNextBRecord 
} 


=  iRIndex; 

=  m_szEmpty; 
=  0; 

=  NULL; 


return  *ppsuCurrBRec ; 

} 


/*  - 

*  Connect  records  into  a  tree  structure 


//  Connect  R  records  with  the  coresponding  G  data  source  record. 

void  vConnectRtoG ( SuGRecord  *  psuFir stGRecord,  SuRRecord  *  psuFir stRRecord) 

{ 

SuRRecord  *  psuCurrRRec; 

SuGDataSource  *  psuCurrGDataSrc; 

//  Walk  through  the  R  record  linked  list,  looking  for  a  match  to  the 
//  appropriate  G  data  source  record. 
psuCurrRRec  =  psuFir stRRecord; 
while  (psuCurrRRec  !=  NULL) 

{ 

//  Step  through  the  G  data  source  records  looking  for  a  match 
psuCurrGDataSrc  =  psuFirstGRecord->psuFirstGDataSource; 
while  (psuCurrGDataSrc  !=  NULL) 

{ 

//  See  if  IDs  match 

if  (strcasecmp (psuCurrGDataSrc->szDataSourceID, 
psuCurrRRec->szDataSourceID)  ==  0) 

{ 

//  If  psuCurrGDataSrc->psuRRecord  !=  NULL  then  that  is  probably  an  error  in  the  TMATS 
file 

psuCurrGDataSrc->psuRRecord  =  psuCurrRRec; 

//  If  R  can't  connect  to  more  than  one  G  then  we  could  break  here. 

}  //  end  if  match 

//  Get  the  next  G  data  source  record 

psuCurrGDataSrc  =  psuCurrGDataSrc->psuNextGDataSource ; 

}  //  end  while  walking  the  G  data  source  records 
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//  Get  the  next  R  record 

psuCurrRRec  =  psuCurrRRec->psuNextRRecord; 

}  //  end  while  walking  the  R  record  list 

return ; 

} 


/*  -  */ 

void  vConnectMtoR ( SuRRecord  *  psuFir stRRecord,  SuMRecord  *  psuFir stMRecord) 

{ 

SuMRecord  *  psuCurrMRec; 

SuRRecord  *  psuCurrRRec; 

SuRDataSource  *  psuCurrRDataSrc; 

//  Walk  through  the  M  record  linked  list,  looking  for  a  match  to  the 
//  appropriate  R  data  source  record. 
psuCurrMRec  =  psuFir stMRecord; 
while  (psuCurrMRec  !=  NULL) 

{ 

//  Walk  the  linked  list  of  R  records 
psuCurrRRec  =  psuFir stRRecord; 
while  (psuCurrRRec  !=  NULL) 

{ 

//  Walk  the  linked  list  of  R  data  sources 
psuCurrRDataSrc  =  psuCurrRRec->psuFir stDataSource ; 
while  (psuCurrRDataSrc  !=  NULL) 

{ 

//  See  if  IDs  match 

if  (strcasecmp (psuCurrRDataSrc->szDataSourceID, 

psuCurrMRec->szDataLinkName)  ==  0) 

{ 

//  If  psuCurrRDataSrc->psuMRecord  !=  NULL  then  that  is  probably  an  error  in  the  TMATS 
file 

psuCurrRDataSrc->psuMRecord  =  psuCurrMRec; 

//  If  M  can't  connect  to  more  than  one  R  then  we  could  break  here. 

}  //  end  if  match 

//  Get  the  next  R  data  source  record 

psuCurrRDataSrc  =  psuCurrRDataSrc->psuNextRDataSource ; 

}  //  end  while  walking  the  R  data  source  records 

//  Get  the  next  R  record 

psuCurrRRec  =  psuCurrRRec->psuNextRRecord; 

} 


//  Get  the  next  M  record 

psuCurrMRec  =  psuCurrMRec->psuNextMRecord; 
}  //  end  while  walking  the  M  record  list 

return ; 

} 


/* 


*/ 
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void  vConnectBtoM ( SuMRecord  *  psuFir stMRecord,  SuBRecord  *  psuFir stBRecord) 

{ 

SuBRecord  *  psuCurrBRec; 

SuMRecord  *  psuCurrMRec; 

//  Walk  through  the  B  record  linked  list,  looking  for  a  match  to  the 
//  appropriate  M  data  source  record. 
psuCurrBRec  =  psuFir stBRecord; 
while  (psuCurrBRec  !=  NULL) 

{ 

//  Walk  the  linked  list  of  M  records 
psuCurrMRec  =  psuFir stMRecord; 
while  (psuCurrMRec  !=  NULL) 

{ 

//  See  if  IDs  match 

if  (strcasecmp (psuCurrMRec->szDataLinkName, 

psuCurrBRec->szDataLinkName)  ==  0) 

{ 

//  If  psuCurrMRecord->psuBRecord  !=  NULL  then  that  is  probably  an  error  in  the  TMATS 
file 

psuCurrMRec->psuBRecord  =  psuCurrBRec; 

//  If  B  can't  connect  to  more  than  one  M  then  we  could  break  here. 

}  //  end  if  match 

//  Get  the  next  R  record 

psuCurrMRec  =  psuCurrMRec->psuNextMRecord; 

} 


//  Get  the  next  M  record 

psuCurrBRec  =  psuCurrBRec->psuNextBRecord; 
}  //  end  while  walking  the  M  record  list 

return ; 

} 


//  - 

//  The  enI106_Decode_Tmats ( )  procedure  mallocO  ' s  a  lot  of  memory.  This 
//  procedure  walks  the  SuMemBlock  list,  freeing  memory  as  it  goes. 

void  110  6_CALL_DECL 

enI106_Free_TmatsInfo (SuTmatsInfo  *  psuTmatsInfo) 

{ 

SuMemBlock  *  psuCurrMemBlock; 

SuMemBlock  *  psuNextMemBlock; 

if  (psuTmatsInfo  ==  NULL) 
return ; 

//  Walk  the  linked  memory  list,  freely  freeing  as  we  head  down  the  freeway 
psuCurrMemBlock  =  psuTmatsInfo->psuFirstMemBlock; 
while  (psuCurrMemBlock  !=  NULL) 

{ 

//  Free  the  memory 

free  (psuCurrMemBlock->pvMemBlock) ; 

//  Free  the  memory  block  and  move  to  the  next  one 
psuNextMemBlock  =  psuCurrMemBlock->psuNextMemBlock; 
free (psuCurrMemBlock) ; 
psuCurrMemBlock  =  psuNextMemBlock; 

} 
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//  Initialize  the  TMATS  info  data  structure 
memset (psuTmatsInfo,  0,  sizeof (SuTmatsInfo) ) ; 

return ; 

} 


//  - 

//  Allocate  memory  but  keep  track  of  it  for  enI106_Free_TmatsInfo ( )  later. 

void  *  TmatsMalloc ( size_t  iSize) 

{ 

void  *  pvNewBuff; 

SuMemBlock  **  ppsuCurrMemBlock; 

//  Malloc  the  new  memory 
pvNewBuff  =  malloc  (iSize) ; 

//  Walk  to  (and  point  to)  the  last  linked  memory  block 
ppsuCurrMemBlock  =  &m_psuTmatsInfo->psuFirstMemBlock; 
while  ( *ppsuCurrMemBlock  !=  NULL) 

ppsuCurrMemBlock  =  & ( *ppsuCurrMemBlock) ->psuNextMemBlock; 

//  Populate  the  memory  block  struct 

*ppsuCurrMemBlock  =  (SuMemBlock  *) malloc (sizeof (SuMemBlock) ) ; 
(*ppsuCurrMemBlock) ->pvMemBlock  =  pvNewBuff; 

(*ppsuCurrMemBlock) ->psuNextMemBlock  =  NULL; 

return  pvNewBuff; 

} 


/*  - 

*  Write  procedures 

*  - *  i 

110 6_CALL_DECL  EnI106Status 

enI106_Encode_Tmats (SuI106Chl0Header  *  psuHeader, 

void  *  pvBuff, 

char  *  szTMATS) 

{ 

//  Channel  specific  data  word 
* (uint32_t  *)pvBuff  =  0; 

//  Figure  out  the  total  TMATS  message  length 
psuHeader->ulDataLen  =  strlen ( szTMATS)  t  4; 

//  Copy  TMATS  setup  info  to  buffer.  This  assumes  there  is  enough 

//  space  in  the  buffer  to  hold  the  TMATS  string. 
strcpy((char  *)pvBuff+4,  szTMATS); 

//  Make  the  data  buffer  checksum  and  update  the  header 
uAddDataFillerChecksum (psuHeader ,  (unsigned  char  *)pvBuff); 

return  I106_OK; 

} 
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Appendix  A-9.  config.h 

/**************************************************************************** 
config.h  -  Define  features  and  OS  portability  macros 
Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

**************************************************************************** y 

#ifndef  _config_h_ 

#define  _config_h_ 

#ifdef  _ cplusplus 

extern  "C"  { 
fendif 

//  .NET  2005  C++  wants  structures  that  are  passed  as  function  parameters  to  be 
declared 

//  as  public.  .NET  2003  and  native  C  pukes  on  that.  C++  Interop  doesn't  seem  to 
care . 

//  Grrrr...  Just  define  out  PUBLIC  for  now  but  leave  in  the  macro  logic  in  case  I 
want 

//  to  revisit  this  someday.  Yeah,  right! 

//#if  _MSC_VER  >=  1400 
//fdefine  PUBLIC  public 
//#else 

#def ine  PUBLIC 
//fendif 

//  .NET  2005  (and  probably  earlier,  but  I'm  not  sure)  define  time_t  to  be  a  64  bit 
value . 

//  And  by  default,  all  the  CRT  time  routines  are  the  64  bit  versions.  For  best 
portability, 

//  time_t  is  assumed  to  be  a  32  bit  value.  The  following  fdefine  tells  .NET  to  use  32 
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bits 

//  as  the  default  time_t  size.  This  needs  to  be  set  in  the  project  properties, 
forces 

//  a  puke  if  it  isn't  set. 

#if  _MSC__VER  >=  14  00 

#if  ! defined (_USE_32BIT_TIME_T) 

fpragma  message ( "WARNING  -  '_USE_32BIT_TIME_T '  not  set!") 

#endif 

#endif 

/*  The  POSIX  caseless  string  compare  is  strcasecmp ( ) .  MSVC  uses  the 
*  non-standard  stricmpO .  Fix  it  up  with  a  macro  if  necessary 
*/ 

#if  defined (_MSC_VER) 

fdefine  strcasecmp (si,  s2)  _stricmp(sl,  s2) 

#define  strncasecmp ( si ,  s2,  n)  _strnicmp (si,  s2,  n) 

#pragma  warning (disable  :  4996) 

#endif 

#def ine  I106_CALL_DECL 

#ifdef  _ cplusplus 

} 

#endif 

#endif 


This 
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Appendix  A-10.  stdint.h 

stdint.h  -  Define  standard  size  integers 
Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

****************************************************************************/ 

#ifndef  _user_stdint_h 
#define  _user_stdint_h 

//  Modern  versions  of  GCC  usually  have  stdint.h  so  include  it  instead 

#if  defined ( _ GNUC _ )  &&  ! defined ( _ DJGPP _ ) 

#include  <stdint.h> 

#endif 


//  The  DJGPP 

#if  defined ( _ DJGPP _ ) 


typedef 

char 

int8  t; 

typedef 

short 

inti  6  t; 

typedef 

int 

int32  t ; 

typedef 

long  long 

int64  t ; 

typedef 

unsigned 

char 

uint8  t; 

typedef 

unsigned 

short 

uintl6  t 

typedef 

unsigned 

int 

uint32  t 

typedef 

#endif 

unsigned 

long  long 

uint64  t 

//  Define  specific  sized  variables  for  MSVC 
#if  defined (_WIN32 ) 

typedef  int8  int8_t; 

typedef  inti 6  intl6_t; 
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typedef  _ int32 

typedef  _ int64 


int32_t; 
int64  t ; 


typedef  unsigned 
typedef  unsigned 
typedef  unsigned 
typedef  unsigned 
#endif 


int8 
inti  6 
int32 
int64 


uint8_t; 
uintl6_t; 
uint32_t ; 
uint64  t ; 


#endif 
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Appendix  B 

Example  Program  -  Calculate  Histogram 

The  following  software  program  opens  a  Chapter  10  file  for  reading,  calculates  a  running 
count  of  each  packet  type  in  each  channel,  and  then  prints  out  these  totals.  It  demonstrates 
reading  individual  Chapter  10  packets,  and  parsing  them  based  on  packet  type. 


/* 


il06stat  -  Generate  histogram-like  statistics  on  a  Irig  106  data  file 
Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 


*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 


This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


#include 

#include 

#include 

#include 

#include 


<stdio . h> 
<stdlib . h> 
<string . h> 
<time . h> 
<assert . h> 


#include 

#include 

#include 

#include 


"conf ig . h" 
"stdint . h" 
"irigl06chl0.h" 
"il06  time.h" 


#include  "il06_decode_time .h" 
#include  "il06_decode_1553fl .h" 
#include  "il06  decode  tmats.h" 
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/* 

*  Macros  and  definitions 


*/ 


#def ine  MAJOR_VERSION  "B1 
#def ine  MINOR_VERSION  "02 

#if  ! defined (bTRUE) 

#def ine  bTRUE  (1==1) 

#def ine  bFALSE  (1==0) 
#endif 

/* 

*  Data  structures 


*/ 


/*  These  hold  the  number  of  messages  of  each  type  for  the  histogram.  */ 


//  1553  channel  counts 
typedef  struct 
{ 

unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
int 

}  SuChanInfol553 ; 


ulTotallrigMsgs ; 
ulTotalBusMsgs ; 
aulMsgs [ 0x4000 ] ; 
aulErrs[0x4000] ; 
ulErrl 553Timeout  ; 
bRT2 RT Found; 


statistics 


/ /  Per  channel 
typedef  struct 
{ 

unsigned  int 
int 

unsigned  long 
unsigned  char 
unsigned  char 
SuChanInfol553 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
unsigned  long 
}  SuChanlnfo; 


iChanID; 
iPrevSeqNum; 
ulSeqNumError ; 
szChanType [32 ] ; 
szChanName [32 ] ; 
psul553Info; 
ul User Defined; 
ulIrigTime; 
ulAnalog; 
ulTMATS ; 
ulEvents ; 
ullndex; 
ulPCM; 

U1MPEG2; 
ulUART; 
ulOther ; 


/* 

*  Module  data 


*/ 

int 

int 


m_bLogRT2RT; 
m  bVerbose; 
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/* 

*  Function  prototypes 


*/ 

void  vPrintCounts ( SuChanlnfo  *  psuChanlnfo,  FILE  *  ptOutFile); 

void  vPrintTmats (SuTmatsInfo  *  psuTmatsInfo,  FILE  *  ptOutFile) ; 

void  vProcessTmats (SuTmatsInfo  *  psuTmatsInfo,  SuChanlnfo  *  apsuChanlnf o [ ] ) 
void  vUsage (void) ; 


/* 


int  main(int  argc,  char  **  argv) 

{ 


to  the  SuChanlnfo  structure 
*  apsuChanlnfo [0x10000] ; 

abyFileStartTime [6]  ; 
abyStartTime [ 6 ]  ; 
abyStopTime [ 6] ; 
bFoundFileStartTime  =  bFALSE; 
bFoundDataStartTime  =  bFALSE; 
ulReadErrors ; 
ulTotal; 


/ /  Array 

of  pointers 

static  SuChanlnfo 

unsigned 

char 

unsigned 

char 

unsigned 

char 

int 

int 

unsigned 

long 

unsigned 

long 

FILE 

int 

char 

char 

int 

unsigned 

short 

unsigned 

long 

unsigned 

long 

unsigned 

int 

EnI106Status 

SuI106Chl0Header 

Sul553Fl_ 

CurrMsg 

SuTmatsInfo 

SuIrigl06Time 

struct  tm 

char 

char 

char 

char 

*  ptOutFile; 
hI106In; 
szInFile [80] ; 
szOutFile [ 80 ] ; 
iArgldx; 
usPackedldx; 
ulBuffSize  =  0L; 
ulReadSize; 

uChanldx; 

enStatus ; 
suI106Hdr; 
sul553Msg; 
SuTmatsInfo; 
sulr igTime ; 

*  psuTmTime; 
szTime [50] ; 

*  szDateTimeFmt  = 

*  szDayTimeFmt  = 

*  szTimeFmt; 


//  Output  file  handle 

//  Input  file  name 
//  Output  file  name 


"%m/%d/%Y  % H : %M : % S " ; 
" %  j : %  H : %M : %  S " ; 


unsigned  char  *  pvBuff  =  NULL; 

//  Make  sure  things  stay  on  UTC 

putenv ("TZ=GMT0" ) ; 
tzset ( ) ; 


*/ 


/* 

*  Initialize  the  channel  info  array  pointers  to  all  NULL 
*/ 


memset (apsuChanlnfo,  0,  sizeof  (apsuChanlnfo) ) ; 
ulTotal  =  0L; 
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ulReadErrors  =  0L; 


/* 

*  Process  the  command  line  arguements 
*/ 


if  (argc  <  2) 
{ 

vUsage  ( ) ; 
return  1; 
} 


m_bVerbose  =  bFALSE; 

m_bLogRT2RT  =  bFALSE; 

szInFilefO]  =  ' \ 0 ' ; 
strcpy (szOutFile,  "")  ; 


//No  verbosity 

//  Don't  keep  track  of  RT  to  RT 
//  Default  is  stdout 


for  (iArgIdx=l;  iArgldxkargc ;  iArgIdx++) 
{ 


switch  (argv [iArgldx] [0] ) 

{ 

//  Handle  command  line  flags 
case  : 

switch  (argv [iArgldx] [1] ) 

{ 

case  ' r'  :  //  Log  RT  to  RT 

m_bLogRT2RT  =  bTRUE; 
break; 

case  ' v'  :  //  Verbose  switch 

m_bVerbose  =  bTRUE; 
break; 

default  ; 
break; 

}  /*  end  flag  switch  */ 
break; 

//  Anything  else  must  be  a  file  name 
default  ; 

if  (szInFilefO]  ==  ' \ 0 ' )  strcpy (szInFile,  argv [ iArgldx] ) ; 
else  strcpy ( szOutFile, argv [ iArgldx] ) ; 

break; 

}  /*  end  command  line  arg  switch  */ 

}  /*  end  for  all  arguments  */ 

if  ( strlen ( szInFile) ==0) 

{ 

vUsage ( ) ; 
return  1; 

} 


/* 

*  Opening  banner 


*/ 


fprintf (stderr,  "\nI106STAT  "MAJOR_VERSION" . "MINOR_VERSION"\n") ; 
fprintf ( stderr ,  "Freeware  Copyright  (C)  2006  Ir iglO 6 . org\n\n" ) ; 
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/* 

*  Opens  file  and  get  everything  init'ed 


*/ 


//  Open  file  and  allocate  a  buffer  for  reading  data. 
enStatus  =  enI106ChlOOpen (&hI106In,  szInFile,  I106_READ) ; 
switch  (enStatus) 

{ 

case  I106_OPEN_WARNING  : 

fprintf ( stderr ,  "Warning  opening  data  file  :  Status  =  %d\n",  enStatus) 
break; 

case  I106_OK  : 

break; 
default  : 

fprintf ( stderr ,  "Error  opening  data  file  :  Status  =  %d\n",  enStatus); 

return  1; 

break; 

} 


enStatus  =  enI106_SyncTime (hI106In,  bFALSE,  0)  ; 
if  (enStatus  !=  I106_OK) 

{ 

fprintf ( stderr ,  "Error  establishing  time  sync  :  Status  =  %d\n",  enStatus); 
return  1; 

} 

//  If  output  file  specified  then  open  it 
if  ( strlen ( szOutFile)  !=  0) 

{ 

ptOutFile  =  fopen ( szOutFile, "w") ; 
if  (ptOutFile  ==  NULL) 

{ 

fprintf ( stderr ,  "Error  opening  output  file\n") ; 
return  1; 

} 

} 

//No  output  file  name  so  use  stdout 
else 


ptOutFile  =  stdout; 

} 


fprintf ( stderr ,  "Computing  histogram. . ,\n"); 


/* 

*  Loop  until  there  are  no  more  message  whilst  keeping  track  of  all  the 

*  various  message  counts. 

~k  _ 

*/ 


while  (1==1) 

{ 

//  Read  the  next  header 

enStatus  =  enI106Chl0ReadNextHeader (hI106In,  &suI106Hdr) ; 

//  Setup  a  one  time  loop  to  make  it  easy  to  break  out  on  error 
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do 

{ 

if  (enStatus  ==  I106_EOF) 

{ 

break; 

} 

//  Check  for  header  read  errors 
if  (enStatus  !=  I106_OK) 

{ 

ulReadErrors++ ; 
break; 

} 

//  Make  sure  our  buffer  is  big  enough,  size  *does*  matter 
if  (ulBuffSize  <  uGetDataLen (&suI106Hdr)  ) 

{ 

pvBuff  =  realloc (pvBuff,  uGetDataLen ( &sul 10 6Hdr )) ; 
ulBuffSize  =  uGetDataLen (&suI106Hdr)  ; 

} 

//  Read  the  data  buffer 
ulReadSize  =  ulBuffSize; 

enStatus  =  enI106Chl0ReadData (hI106In,  ulBuffSize,  pvBuff); 

//  Check  for  data  read  errors 
if  (enStatus  !=  I106_OK) 

{ 

ulReadErrors++ ; 
break; 

} 

//  If  this  is  a  new  channel,  malloc  some  memory  for  counts  and 
//  set  the  pointer  in  the  channel  info  array  to  it. 
if  (apsuChanlnfo [ sul 10 6Hdr . uChID]  ==  NULL) 

{ 

apsuChanlnfo [sul 10 6Hdr . uChID]  = 

(SuChanlnfo  *) malloc (sizeof (SuChanlnfo) )  ; 
memset (apsuChanlnfo [ sull 06Hdr . uChID] ,  0,  sizeof  (SuChanlnfo) ) ; 
apsuChanlnfo [ sul 10 6Hdr . uChID] ->iChanID  =  sull 06Hdr . uChID; 

//  Now  save  channel  type  and  name 
if  ( sull 06Hdr . uChID  ==  0) 

{ 

strcpy (apsuChanlnfo [ sull 06Hdr . uChID] ->szChanType,  "RESERVED" ) ; 
strcpy (apsuChanlnfo [ sull 06Hdr . uChID] ->szChanName,  "SYSTEM") ; 

} 

else 

{ 

strcpy (apsuChanlnfo [ sull 06Hdr . uChID] ->szChanType,  "UNKNOWN" ) ; 
strcpy (apsuChanlnfo [ sull 06Hdr .uChID] ->szChanName,  "UNKNOWN" ) ; 

} 

} 

ulTotal++; 
if  (m_bVerbose) 

fprintf ( stderr ,  "%8.81d  Messages  \r",  ulTotal)  ; 

//  Save  data  start  and  stop  times 

if  ( (suI106Hdr .ubyDataType  !=  I106CH10_DTYPE_TMATS)  && 

( sul 10  6Hdr . ubyDataType  !=  I106CH10_DTYPE_IRIG_TIME)  ) 

{ 

if  (bFoundDataStartTime  ==  bFALSE) 

{ 
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memcpy((char  * ) abyStartTime,  (char  * ) sull 06Hdr . aubyRefTime,  6); 
bFoundDataStartTime  =  bTRUE; 

} 

else 

{ 

memcpy((char  * ) abyStopTime,  (char  *) sul 10 6Hdr . aubyRefTime,  6); 

} 

}  //  end  if  data  message 

//  Log  the  various  data  types 
switch  (suI106Hdr.ubyDataType) 

{ 

case  1 1 0 6CH1 0_DTYPE_USER_DEFINED  :  //  0x00 

apsuChanlnfo [ sul 10  6Hdr . uChID] -RulUserDef ined+  +  ; 
break; 

case  110 6CH1 0_DTYPE_TMATS  :  //  0x01 

apsuChanlnfo [suI106Hdr. uChID] ->ulTMATS++; 

//  Only  decode  the  first  TMATS  record 
if  (apsuChanlnfo [suI106Hdr. uChID] ->ulTMATS  !=  0) 

{ 

//  Save  file  start  time 

memcpy ( ( char  * ) SabyFileStartTime, 

(char  *) sul 10 6Hdr . aubyRefTime,  6); 

//  Process  TMATS  info  for  later  use 

enll 06_Decode_Tmats ( &sull 06Hdr ,  pvBuff,  SsuTmatsInfo) ; 
if  (enStatus  !=  I106_OK) 
break; 

vProcessTmats ( SsuTmatsInf o,  apsuChanlnfo)  ; 

} 

break; 

case  110 6CH1 0_DTYPE_RECORDING_EVENT  ;  //  0x02 

apsuChanlnfo [sul 10  6Hdr . uChID] ->ulEvents++ ; 
break; 

case  110 6CH1 0_DTYPE_RECORDING_INDEX  :  //  0x03 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ul Index!  +  ; 
break; 

case  1 1 0 6CH1 0_DT YPE_PCM  :  //  0x09 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ulPCM+  +  ; 
break; 

case  1 1 0 6CH1 0_DTYPE_IRIG_TIME  :  //  0x11 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ullr igTime++ ; 
break; 

case  1 1 0 6CH1 0_DT YPE_1 5 53_FMT_1  :  //  0x19 

//  If  first  1553  message  for  this  channel,  setup  the  1553  counts 
if  (apsuChanlnfo [ sul 10 6Hdr . uChID] ->psul 553Info  ==  NULL) 

{ 

apsuChanlnfo [ sul 10  6Hdr ,uChID]->psul553Info  = 
malloc (sizeof (SuChanInfol553) ) ; 
memset (apsuChanlnfo [ sul 10  6Hdr ,uChID]->psul553Info, 

0x00,  sizeof (SuChanInfol553) ) ; 

} 


apsuChanlnfo [ sul 10  6Hdr . uChID] ->psul 553Inf o->ulTotal!rigMsgs++ ; 
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//  Step  through  all  1553  messages 

enStatus  =  enI106_Decode_Firstl553Fl (&suI106Hdr,  pvBuff, 

&sul553Msg) ; 

while  (enStatus  ==  I106_OK) 

{ 

//  Update  message  count 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->psul553Info->ulTotalBusMsgs  +  +  ; 
usPackedldx  =  (sul553Msg.psuCmdWordl->uValue  »  5)  &  0x3FFF; 
apsuChanlnfo [sul 10  6Hdr . uChID] ->psul553Info- 

>aulMsgs [usPackedldx] ++; 


//  Update  the  error  counts 

if  ( sul553Msg . psul 553Hdr->bMsgError  !=  0) 

apsuChanlnfo [sul 10  6Hdr . uChID] ->psul553Info- 

>aulErrs [usPackedldx] ++; 


if  ( sul553Msg . psul 553Hdr->bRespTimeout  !=  0) 
apsuChanlnfo [ sul 10  6Hdr . uChID] ->psul553Info- 

>ulErrl553Timeout++; 


//  Get  the  next  1553  message 

enStatus  =  enI106_Decode_Nextl553Fl (&sul553Msg) ; 
} 


//  If  logging  RT  to  RT  then  do  it  for  second  command  word 
if  ( sul553Msg . psul 553Hdr->bRT2RT  ==  1) 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->psul 553Inf o->bRT2RTFound  = 

bTRUE; 


if  (m_bLogRT2RT==bTRUE) 

{ 

usPackedldx  =  (sul553Msg.psuCmdWord2->uValue  »  5)  &  0x3FFF; 
apsuChanlnfo [ sul 10  6Hdr .uChID] ->psul553Info- 

>aulMsgs [usPackedldx] ++; 

}  //  end  if  logging  RT  to  RT 


break; 

case  1 1 0 6CH1 0_DT YPE_ANALOG  :  //  0x21 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ulAnalog++ ; 
break; 

case  1 1 0 6CH1 0_DT YPE_VI DEO_FMT_0  :  //  0x40 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ulMPEG2  +  +  ; 
break; 

case  1 1 0 6CH1 0_DT YPE_UART_FMT_0  :  //  0x50 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ulUART++ ; 
break; 

default : 

apsuChanlnfo [ sul 10  6Hdr . uChID] ->ulOther+  +  ; 
break; 

}  //  end  switch  on  message  type 

}  while  (bFALSE) ;  //  end  one  time  loop 

//  If  EOF  break  out  of  main  read  loop 
if  (enStatus  ==  I106_EOF) 

{ 
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break; 

} 


}  /*  End  while  */ 


/* 

*  Now  print  out  the  results  of  histogram. 


//  vPrintTmats ( SsuTmatsInfo,  ptOutFile)  ; 

fprintf (ptOutFile, "\n=-=-=  Message  Totals  by  Channel  and  Type  = 
for  (uChanIdx=0;  uChanIdx<0xl000 ;  uChanIdx++) 

{ 

if  (apsuChanlnfo [uChanldx]  !=  NULL) 

{ 

vPrintCounts (apsuChanlnfo [uChanldx] ,  ptOutFile) ; 

} 


fprintf (ptOutFile, "=-=-=  File  Time  Summary  =-=-=\n\n") ; 

enI106_Rel2IrigTime (hI106In,  abyFileStartTime,  SsuIrigTime) ; 
if  ( sulr igTime . enFmt  ==  I106_DATEFMT_DMY) 
szTimeFmt  =  szDateTimeFmt; 

else 

szTimeFmt  =  szDayTimeFmt ; 

psuTmTime  =  gmtime ( ( time_t  * ) &  ( suIrigTime . ulSecs) ) ; 
strftime (szTime,  50,  szTimeFmt,  psuTmTime); 
fprintf (ptOutFile, "File  Start  %s\n",  szTime) ; 

enI106_Rel2IrigTime (hI106In,  abyStartTime,  SsuIrigTime); 
psuTmTime  =  gmtime (( time_t  *) S ( suIrigTime . ulSecs) ) ; 
strftime (szTime,  50,  szTimeFmt,  psuTmTime); 
fprintf (ptOutFile, "Data  Start  %s\n",  szTime); 

enI106_Rel2IrigTime (hI106In,  abyStopTime,  SsuIrigTime); 
psuTmTime  =  gmtime (( time_t  *) S ( suIrigTime . ulSecs) ) ; 
strftime (szTime,  50,  szTimeFmt,  psuTmTime); 
fprintf (ptOutFile, "Data  Stop  %s\n\n",  szTime); 

fprintf (ptOutFile, "\nTOTAL  RECORDS:  %101u\n\n",  ulTotal); 


/* 

*  Free  dynamic  memory. 

*  / 


free (pvBuff ) ; 
pvBuff  =  NULL; 

fclose (ptOutFile) ; 

return  0; 

} 


/*  - 

void  vPrintCounts ( SuChanlnfo  *  psuChanlnfo,  FILE  *  ptOutFile) 
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{ 

long  lMsgldx; 

//  Make  Channel  ID  line  lead-in  string 
fprintf (ptOutFile, "ChanID  %3d  :  %s  :  %s\n", 

psuChanlnf o->iChanID,  psuChan!nfo->szChanType,  psuChan!nfo->szChanName) ; 


if 

(psuChanInfo->ulTMATS  != 

^  0) 

fprintf (ptOutFile, " 

TMATS 

%101u\n". 

psuChanInfo->ulTMATS)  ; 

if 

(psuChanlnf o->ulEvents  ! 

=  0) 

fprintf (ptOutFile, " 

Events 

%101u\n". 

psuChanlnf o->ulEvents ) ; 

if 

(psuChanlnf o->ulIndex  !  = 

:  0) 

fprintf (ptOutFile, " 

Index 

%101u\n". 

psuChanlnf o->ulIndex) ; 

if 

(psuChanlnf o->ul I rigTime 

:  !  =  0) 

fprintf (ptOutFile, " 

IRIG  Time 

%101u\n". 

psuChanlnf o->ul I rigTime) 

if  ( (psuChanInfo->psul 553Inf o  !=  NULL)  && 

(psuChanInfo->psul 553Inf o->ulTotalBusMsgs  !=  0)) 

{ 

//  Loop  through  all  RT,  TR,  and  SA  combinations 
for  (lMsgIdx=0;  lMsgIdx<0x4000 ;  lMsgIdx++) 

{ 

if  (psuChanInfo->psul553Info->aulMsgs [lMsgldx]  !=  0) 

{ 

fprintf (ptOutFile, "  RT  %2d  %c  SA  %2d  Msgs  %91u  Errs  %91u\n", 
(lMsgldx  »  6)  &  OxOOlf, 

(lMsgldx  »  5)  &  0x0001  ?  'T'  :  'R', 

(lMsgldx  )  &  OxOOlf, 

psuChanInfo->psul553Info->aulMsgs [lMsgldx] , 
psuChanInfo->psul553Info->aulErrs [lMsgldx] ) ; 

}  //  end  if  count  not  zero 
}  //  end  for  each  combination 

if  (psuChanInfo->psul553Info->bRT2RTFound  ==  bTRUE) 

{ 

fprintf (ptOutFile, "\n  Warning  -  RT  to  RT  transfers  found  in  the  data\n") 
if  (m_bLogRT2RT  ==  bTRUE) 
fprintf (ptOutFile, 

"  Message  total  is  NOT  the  sum  of  individual  RT  totals\n") 

else 

fprintf (ptOutFile, 

"  Some  transmit  RTs  may  not  be  shown\n") ; 

}  //  end  if  RT  to  RT 

fprintf (ptOutFile, "  Totals  -  %ld  Message  in  %ld  IRIG  RecordsXn", 
psuChanlnf o->psul 5 53 Inf o->ulTotalBusMsgs, 
psuChanlnf o->psul 5 53 Inf o->ulTotalIr igMsgs ) ; 

}  //  end  if  1553  messages 

if  (psuChanInfo->ulPCM  !=  0) 

fprintf (ptOutFile, "  PCM  %101u\n",  psuChanlnf o->ulPCM) ; 

if  (psuChanlnf o->ulAnalog  !=  0) 

fprintf (ptOutFile, "  Analog  %101u\n",  psuChanlnf o->ulAnalog) ; 

if  (psuChanlnf o->ulMPEG2  !=  0) 

fprintf (ptOutFile, "  MPEG  Video  %101u\n",  psuChanlnf o->ulMPEG2 ) ; 

if  (psuChanlnf o->ulUART  !=  0) 


B-10 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


fprintf (ptOutFile, "  UART 


%101u\n",  psuChanInfo->ulUART) ; 


if  (psuChanlnf o->ulUserDef ined  !=  0) 

fprintf (ptOutFile, "  User  Defined  %101u\n", 

>ulUserDef ined) ; 


if  (psuChanlnf o->ulOther 
fprintf (ptOutFile, " 


!=  0) 

Other  messages 


%101u\n". 


psuChanlnf o- 


psuChanlnf o->ulOther ) 


fprintf (ptOutFile, "\n",  psuChanlnf o->ulOther )  ; 

return ; 

} 


/*  -  */ 

void  vPrintTmats (SuTmatsInfo  *  psuTmatsInf o,  FILE  *  ptOutFile) 

{ 


int 

iGIndex; 

int 

iRIndex; 

int 

iRDsilndex; 

SuGDataSource 

*  psuGDataSource 

SuRRecord 

*  psuRRecord; 

SuRDataSource 

*  psuRDataSource 

//  Print  out  the  TMATS  info 
// - 

fprintf (ptOutFile, "\n=-=-=  Channel  Summary  =-=-=\n\n")  ; 

//  G  record 

fprintf (ptOutFile, "Program  Name  -  %s\n", psuTmatsInf o->psuFirstGRecord- 
>szProgramName) ; 

fprintf (ptOutFile, "IRIG  106  Rev  -  %s\n", psuTmatsInf o->psuFirstGRecord- 


>szIrigl06Rev) ; 

fprintf (ptOutFile, "Channel  Type  Data  Source  \n")  ; 

fprintf  (ptOutFile,  " -  -  - \n")  ; 


//  Data  sources 

psuGData Source  =  psuTmatsInf o->psuFirstGRecord->psuFirstGData Source ; 
do  { 

if  (psuGDataSource  ==  NULL)  break; 

//  G  record  data  source  info 

iGIndex  =  psuGDataSource->iDataSourceNum; 

//  R  record  info 

psuRRecord  =  psuGDataSource->psuRRecord; 
do  { 

if  (psuRRecord  ==  NULL)  break; 
iRIndex  =  psuRRecord->iRecordNum; 

//  R  record  data  sources 

psuRDataSource  =  psuRRecord- >psuFir stDataSource ; 
do  { 

if  (psuRDataSource  ==  NULL)  break; 
iRDsilndex  =  psuRDataSource->iDataSourceNum; 
fprintf (ptOutFile, "  %5i  ",  psuRDataSource->iTrackNumber ) ; 
fprintf (ptOutFile, "  %-12s",  psuRDataSource->szChannelDataType) ; 

fprintf (ptOutFile, "  %-20s",  psuRDataSource->szDataSourceID) ; 

fprintf (ptOutFile,  "\n")  ; 
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psuRDataSource  =  psuRDataSource->psuNextRDataSource ; 
}  while  (bTRUE) ; 

psuRRecord  =  psuRRecord->psuNextRRecord; 

}  while  (bTRUE); 


psuGDataSource  = 

psuTmatsInfo->psuFir stGRecord->psuFir stGDataSource->psuNextGDataSource; 
}  while  (bTRUE) ; 

return ; 

} 


/* 


*/ 


void  vProcessTmats (SuTmatsInfo 
{ 


//  unsigned 

//  unsigned  char 

SuRRecord 
SuRDataSource 


psuTmatsInf o 

uArrayldx; 

ul553ChanIdx; 

psuRRecord; 

psuRDataSrc; 


SuChanlnfo  *  apsuChanlnf o [  ]  ) 


//  Find  channels  mentioned  in  TMATS  record 
psuRRecord  =  psuTmatsInf o->psuFirstRRecord; 
while  (psuRRecord  !=  NULL) 

{ 

//  Get  the  first  data  source  for  this  R  record 
psuRDataSrc  =  psuRRecord->psuFirstDataSource; 
while  (psuRDataSrc  !=  NULL) 

{ 

//  Make  sure  a  message  count  structure  exists 
if  (apsuChanlnfo [psuRDataSrc->iTrackNumber ]  ==  NULL) 

{ 

//  SOMEDAY  PROBABLY  WANT  TO  HAVE  DIFFERENT  COUNT  STRUCTURES  FOR  EACH  CHANNEL  TYPE 

apsuChanlnfo [psuRDataSrc->iTrackNumber ]  =  malloc (sizeof (SuChanlnfo) ) 
memset (apsuChanlnfo [psuRDataSrc->iTrackNumber ]  ,  0, 
sizeof (SuChanlnfo) ) ; 

apsuChanlnfo [psuRDataSrc->iTrackNumber ] ->iChanID  =  psuRDataSrc- 

>iTrackN umber ; 

} 


//  Now  save  channel  type  and  name 

strcpy (apsuChanlnfo [psuRDataSrc->iTrackNumber ] ->szChanType, 
psuRDataSrc->szChannelDataType) ; 
strcpy (apsuChanlnfo [psuRDataSrc->iTrackNumber ] ->szChanName, 
psuRDataSrc->szDataSourceID)  ; 

//  Get  the  next  R  record  data  source 
psuRDataSrc  =  psuRDataSrc->psuNextRDataSource ; 

}  //  end  while  walking  R  data  source  linked  list 

//  Get  the  next  R  record 

psuRRecord  =  psuRRecord->psuNextRRecord; 

}  //  end  while  walking  R  record  linked  list 

return ; 

} 
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/*  -  */ 

void  vUsage(void) 

{ 

printf ("\nI106STAT  "MAJOR_VERSION" . "MINOR_VERSION"  " _ DATE _ "  " _ TIME _ "\n"); 


printf  ("Print  totals  by  channel  and  message  type  from  a  Ch  10  data  file\n") ; 

printf  ("Freeware  Copyright  (C)  2006  Irigl06 . org\n\n") ; 

printf ("Usage :  il06stat  <input  file>  <output  file>  [flags] \n"); 

printf  ("  <filename>  Input/output  file  names\n") ; 

printf  ("  -r  Log  both  sides  of  RT  to  RT  transf er s\n" ) ; 

printf  ("  -v  VerboseXn") ; 

} 
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Appendix  C 

Example  Program  -  Decode  TMATS 

The  following  software  program  opens  a  Chapter  10  file  for  reading,  extracts  the  TMATS 
setup  record,  and  displays  it  one  of  several  ways.  It  demonstrates  reading  a  Chapter  9  TMATS 
packets,  and  parsing  the  TMATS  attributes. 

/*========================================================================== 

idmptmat  -  Read  and  dump  a  TMATS  record  from  an  IRIG  106  Ch  10  data  file 
Copyright  (c)  2006  Irigl06.org 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

*************************************************************************•*•**/ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <time.h> 

#include  <assert.h> 

#include  "stdint.h" 

#include  "irigl06chl0.h" 

#include  "il06_decode_tmats.h" 

/* 

*  Macros  and  definitions 

*  _ 
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*/ 


#def ine  MAJOR_VERSION  "01 
#def ine  MINOR_VERSION  "01 

#if  ! defined (bTRUE) 

#def ine  bTRUE  (1==1) 

#def ine  bFALSE  (1==0) 
#endif 


/* 

*  Module  data 


*/ 


/* 

*  Function  prototypes 


*/ 

void  vDumpRaw (SuI106Chl0Header  *  psuI106Hdr,  void  *  pvBuff,  FILE  *  ptOutFile); 
void  vDumpTree (SuI106Chl0Header  *  psuI106Hdr,  void  *  pvBuff,  FILE  *  ptOutFile); 
void  vDumpChannel (SuI106Chl0Header  *  psuI106Hdr,  void  *  pvBuff,  FILE  *  ptOutFile) 
void  vUsage (void) ; 


int  main(int  argc,  char  **  argv) 

{ 


char 

char 

int 

FILE 

int 

int 

int 

unsigned  long 


szInFile [80] ; 
szOutFile [ 80 ] ; 
iArgldx; 
ptOutFile; 
bRawOutput  ; 
bTreeOutput; 
bChannelOutput  ; 
ulBuffSize  =  0L; 


//  Input  file  name 
//  Output  file  name 

//  Output  file  handle 


int 

EnI106Status 

SuI106Chl0Header 


iI106Chl0Handle; 
enStatus ; 
suI106Hdr; 


unsigned  char 


pvBuff 


NULL; 


/*  Make  sure  things  stay  on  UTC  */ 

putenv  ("TZ=GMT0" ) ; 
tzset ( )  ; 

/* 

*  Process  the  command  line  arguements 
*/ 


if  (argc  <  2)  { 

vUsage  ( ) ; 
return  1; 

} 
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bRawOutput  =  bFALSE;  //No  verbosity 

bTreeOutput  =  bFALSE; 

bChannelOutput  =  bFALSE; 

szInFilefO]  =  ' \ 0 ' ; 

strcpy (szOutFile, "") ;  //  Default  is  stdout 

for  (iArgIdx=l;  iArgIdx<argc ;  iArgIdx++) 

{ 

switch  (argv [iArgldx] [0]) 

{ 

//  Handle  command  line  flags 
case  : 

switch  (argv [iArgldx] [1] ) 

{ 

case  ' r'  :  //  Raw  output 

bRawOutput  =  bTRUE; 
break; 


case  't'  :  //  Tree  output 

bTreeOutput  =  bTRUE; 
break; 

case  'c'  :  //  Channel  summary 

bChannelOutput  =  bTRUE; 
break; 

default  : 
break; 

}  //  end  flag  switch 
break; 

//  Anything  else  must  be  a  file  name 
default  ; 

if  (szInFilefO]  ==  ' \ 0 ' )  strcpy (szInFile,  argv [ iArgldx] ) 
else  strcpy (szOutFile, argv [iArgldx] ) 

break; 

}  //  end  command  line  arg  switch 
}  //  end  for  all  arguments 

if  ( strlen ( szInFile) ==0) 

{ 

vUsage ( ) ; 
return  1; 

} 


//  Make  sure  at  least  on  output  is  turned  on 
if  ( (bRawOutput  ==  bFALSE)  && 

(bTreeOutput  ==  bFALSE)  && 
(bChannelOutput  ==  bFALSE) ) 
bChannelOutput  =  bTRUE; 


/* 

*  Opening  banner 


*/ 

fprintf (stderr,  "\nIDMPTMAT  "MAJOR_VERSION" . "MINOR_VERSION"\n") ; 
fprintf ( stderr ,  "Freeware  Copyright  (C)  2006  Ir iglO 6 . org\n\n" )  ; 
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/* 

*  Open  file  and  get  everything  init'ed 


*/ 


//  Open  file  and  allocate  a  buffer  for  reading  data. 

enStatus  =  enI106ChlOOpen ( &ill 06Chl0Handle,  szInFile,  I106_READ) ; 

switch  (enStatus) 

{ 

case  I106_OPEN_WARNING  : 

fprintf ( stderr ,  "Warning  opening  data  file  :  Status  =  %d\n",  enStatus) 
break; 

case  110 6_OK  : 

break; 
default  : 

fprintf ( stderr ,  "Error  opening  data  file  :  Status  =  %d\n",  enStatus); 

return  1; 

break; 

} 


//  If  output  file  specified  then  open  it 
if  (strlen (szOutFile)  !=  0) 

{ 

ptOutFile  =  fopen ( szOutFile, "w") ; 
if  (ptOutFile  ==  NULL) 

{ 

fprintf ( stderr ,  "Error  opening  output  file\n") ; 
return  1; 

} 

} 

//No  output  file  name  so  use  stdout 
else 

{ 

ptOutFile  =  stdout; 

} 


/* 

*  Read  the  TMATS  record 
*/ 


//  Read  the  next  header 

enStatus  =  enI106Chl0ReadNextHeader (iI106Chl0Handle,  &suI106Hdr) ; 

if  (enStatus  !=  I106_OK) 

{ 

fprintf ( stderr ,  "  Error  reading  header  :  Status  =  %d\n",  enStatus); 
return  1; 

} 

//  Make  sure  our  buffer  is  big  enough,  size  *does*  matter 
if  (ulBuffSize  <  uGetDataLen (&suI106Hdr) ) 

{ 

pvBuff  =  realloc  (pvBuff,  uGetDataLen (&suI106Hdr) ) ; 
ulBuffSize  =  uGetDataLen (&suI106Hdr)  ; 

} 

//  Read  the  data  buffer 

enStatus  =  enI106Chl0ReadData (iI106Chl0Handle,  ulBuffSize,  pvBuff); 
if  (enStatus  !=  I106_OK) 

{ 

fprintf ( stderr ,  "  Error  reading  data  :  Status  =  %d\n",  enStatus); 
return  1; 
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} 

if  ( sull 06Hdr . ubyDataType  !=  I106CH10_DTYPE_TMATS) 

{ 

fprintf ( stderr ,  "  Error  reading  data  :  first  message  not  TMATS"); 
return  1; 

} 

//  Generate  output 

fprintf (ptOutFile,  "IDMPTMAT  "MAJOR^VERSION" . "MINOR_VERSION"\n" ) ; 
fprintf (ptOutFile,  "TMATS  from  file  %s\n\n",  szInFile) ; 

if  (bRawOutput  ==  bTRUE) 

vDumpRaw (&suI106Hdr,  pvBuff,  ptOutFile); 

if  (bTreeOutput  ==  bTRUE) 

vDumpTree ( &sul 10 6Hdr ,  pvBuff,  ptOutFile); 

if  (bChannelOutput  ==  bTRUE) 

vDumpChannel (&suI106Hdr,  pvBuff,  ptOutFile) ; 

//  Done  so  clean  up 
free  (pvBuff) ; 
pvBuff  =  NULL; 

fclose  (ptOutFile) ; 

return  0; 

} 


/*  -  */ 

//  Output  the  raw,  unformated  TMATS  record 

void  vDumpRaw (SuI106Chl0Header  *  psuI106Hdr,  void  *  pvBuff,  FILE  *  ptOutFile) 

{ 

unsigned  long  IChrldx; 

char  *  achBuff  =  pvBuff; 

for  (IChrldx  =  0;  lChrIdx<psuI106Hdr->ulDataLen;  10hrldx++) 
fputc (achBuff [ IChrldx] ,  ptOutFile)  ; 

return ; 

} 


/* 


*/ 


void  vDumpTree (SuI106Chl0Header  *  psuI106Hdr,  void  *  pvBuff, 


{ 

EnI106Status 

int 

int 

int 

SuTmatsInf o 
SuGDataSource 
SuRRecord 
SuRDataSource 


enStatus ; 

iGIndex; 

iRIndex; 

iRDsilndex; 

suTmatsInfo; 

*  psuGDataSource; 

*  psuRRecord; 

*  psuRDataSource; 


FILE  *  ptOutFile) 


//  Process  the  TMATS  info 

enStatus  =  enI106_Decode_Tmats (psuI106Hdr,  pvBuff,  SsuTmatsInfo) ; 
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if  (enStatus  !=  I106_OK) 

{ 

fprintf ( stderr ,  "  Error  processing  TMATS  record  :  Status  =  %d\n",  enStatus) 
return ; 

} 


//  Print  out  the  TMATS  info 
// - 

//  G  record 
fprintf (ptOutFile, 

"(G)  Program  Name  -  %s\n", suTmatsInf o . psuFirstGRecord->szProgramName) ; 
fprintf (ptOutFile, 

"(G)  IRIG  106  Rev  -  %s\n",  suTmatsInf o . psuFirstGRecord->szIr iglO 6Rev) ; 

//  Data  sources 

psuGDataSource  =  suTmatsInfo . psuFir stGRecord- >psuFirs tGDataSource ; 
do  { 

if  (psuGDataSource  ==  NULL)  break; 

//  G  record  data  source  info 

iGIndex  =  psuGDataSource->iDataSourceNum; 

fprintf (ptOutFile,  "  (G\\DSI-%i)  Data  Source  ID  -  %s\n", 

psuGDataSource->iDataSourceNum, 

suTmatsInfo . psuFir stGRecord->psuFir stGDataSource->szDataSourceID) ; 
fprintf (ptOutFile,  "  (G\\DST-%i)  Data  Source  Type  -  %s\n", 

psuGDataSource->iDataSourceNum, 

suTmatsInfo . psuFir stGRecord->psuFir stGDataSource->szDataSourceType) ; 
//  R  record  info 

psuRRecord  =  psuGDataSource->psuRRecord; 
do  { 

if  (psuRRecord  ==  NULL)  break; 
iRIndex  =  psuRRecord->iRecordNum; 

fprintf (ptOutFile,  "  (R-%i\\ID)  Data  Source  ID  -  %s\n", 

iRIndex,  psuRRecord->szDataSourceID) ; 

//  R  record  data  sources 

psuRDataSource  =  psuRRecord- >psuFir stDataSource ; 
do  { 

if  (psuRDataSource  ==  NULL)  break; 
iRDsilndex  =  psuRDataSource->iDataSourceNum; 
fprintf  (ptOutFile, 

"  (R-%i\\DSI-%i )  Data  Source  ID  -  %s\n", 

iRIndex,  iRDsilndex,  psuRDataSource->szDataSourceID) ; 
fprintf  (ptOutFile, 

"  (R-%i\\DST-%i )  Channel  Type  -  %s\n", 

iRIndex,  iRDsilndex,  psuRDataSource->szChannelDataType) ; 
fprintf (ptOutFile, 

"  (R-%i\\TKl-%i )  Track  Number  -  %i\n", 

iRIndex,  iRDsilndex,  psuRDataSource->iTrackNumber ) ; 
psuRDataSource  =  psuRDataSource->psuNextRDataSource ; 

}  while  (bTRUE) ; 

psuRRecord  =  psuRRecord->psuNextRRecord; 

}  while  (bTRUE) ; 


psuGDataSource  = 

suTmatsInfo . psuFir stGRecord->psuFir stGDataSource- RpsuNextGDataSource; 
}  while  (bTRUE); 
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return ; 

} 


/* 


*/ 


(SuI106Chl0Header  *  psuI106Hdr 


void  vDumpChannel 

{ 

EnI106Status 

int 

int 

int 

SuTmatsInf o 
SuGDataSource 
SuRRecord 
SuRDataSource 


enStatus ; 

iGIndex; 

iRIndex; 

iRDsilndex; 

suTmatsInfo; 

*  psuGDataSource; 

*  psuRRecord; 

*  psuRDataSource; 


void  *  pvBuff,  FILE  *  ptOutFile) 


//  Process  the  TMATS  info 

enStatus  =  enI106_Decode_Tmats (psuI106Hdr,  pvBuff,  SsuTmatsInfo) ; 
if  (enStatus  !=  I106_OK) 

{ 

fprintf ( stderr ,  "  Error  processing  TMATS  record  :  Status  =  %d\n",  enStatus) 
return ; 

} 


//  Print  out  the  TMATS  info 
// - 

//  G  record 
fprintf (ptOutFile, 

"Program  Name  -  %s\n", suTmatsInfo . psuFirstGRecord->szProgramName) ; 
fprintf (ptOutFile, 

"IRIG  106  Rev  -  %s\n", suTmatsInf o . psuFirstGRecord->szIr iglO 6Rev) ; 
fprintf (ptOutFile, 

"Channel  Type  Enabled  Data  Source  \n"); 

fprintf (ptOutFile, 

- -  -  -  - \n")  ; 


//  Data  sources 

psuGDataSource  =  suTmatsInfo . psuFirstGRecord->psuFirstGDataSource ; 
do  { 

if  (psuGDataSource  ==  NULL)  break; 

//  G  record  data  source  info 

iGIndex  =  psuGDataSource->iDataSourceNum; 


//  R  record  info 

psuRRecord  =  psuGDataSource->psuRRecord; 
do  { 

if  (psuRRecord  ==  NULL)  break; 
iRIndex  =  psuRRecord->iRecordNum; 


"Dis")  ; 


//  R  record  data  sources 

psuRDataSource  =  psuRRecord- >psuFir stDataSource ; 
do  { 

if  (psuRDataSource  ==  NULL)  break; 
iRDsilndex  =  psuRDataSource->iDataSourceNum; 

fprintf  (ptOutFile,  "  %5i  ",  psuRDataSource->iTrackNumber) ; 
fprintf (ptOutFile,  "  %-12s",  psuRDataSource->szChannelDataType) ; 

fprintf (ptOutFile,  "  %-8s",  psuRDataSource->bEnabled  ?  "En"  : 


fprintf (ptOutFile, 


%-20s",  psuRDataSource->szDataSourceID) ; 
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fprintf (ptOutFile,  "\n")  ; 

psuRDataSource  =  psuRDataSource->psuNextRDataSource ; 
}  while  (bTRUE) ; 

psuRRecord  =  psuRRecord->psuNextRRecord; 

}  while  (bTRUE); 


psuGDataSource  = 

suTmatsInf o . psuFir stGRecord->psuFir stGDataSource->psuNextGDataSource 
}  while  (bTRUE) ; 

return ; 

} 


r 


IDMPTMAT  "MAJOR  VERSION" 


''MINOR  VERSION" 


void  vUsage(void) 

{ 

printf  ("\n IDMPTMAT 
" _ TIME _ "\n") ; 

printf ("Read  and  output  TMATS  record  from  a  Ch  10  data  file\n") 
printf  ("Freeware  Copyright  (C)  2006  Irigl06 . org\n\n") ; 
printf  ("Usage :  idmptmat  <infile>  <outfile>  <flags>\n") ; 

channel  summary  format  (default) \n") ; 
tree  view  formatin'')  ; 
raw  TMATS\n")  ; 

return ; 


printf  (" 

-c 

Output 

printf  (" 

-t 

Output 

printf  (" 

-r 

Output 

DATE 
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Appendix  D 

Example  C  Program  -  Display  Channel  Details 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  displays  channel 
ID  and  data  type  for  each  channel  as  well  as  a  count  of  how  many  packets  are  present  for  each 
channel  in  a  chapter  10  file. 


/* 


stat.c  -  Display  some  basic  information  about  the  channels  within  a  Chapter  10 
file . 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

****************************************************************************/ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <stdint.h> 

#include  "irigl06chl0 . h" 

#include  "stat_args . c" 

#include  "common. h" 

typedef  struct  { 

unsigned  int  type; 

int  id; 

int  packets; 
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}  ChanSpec; 


int  main(int  argc,  char  **  argv) { 

//  Get  commandline  args. 

DocoptArgs  args  =  docopt (argc,  argv,  1,  "1") ; 
if  (args .help) { 

printf  (args . help_message)  ; 
return  1; 

} 

else  if  (argc  <  2) { 

printf (args . usage_pattern) ; 
return  1; 

} 

SuI106Chl0Header  header; 

int  packets  =  0,  input_handle; 

float  byte_size  =  0.0; 

static  ChanSpec  *  channels [0x10000] ; 

//  Open  the  source  file. 

EnI106Status  status  =  enI106ChlOOpen (&input_handle,  argv[l],  I106_READ) 
if  (status  !=  I106_OK) { 

char  msg[200]  =  "Error  opening  file  "; 
strcat (msg,  argvfl]); 
return  error  (msg) ; 

} 


//  Iterate  over  selected  packets  (based  on  args). 
while  ( 1 )  { 

status  =  enl 10 6Chl OReadNextHeader ( input_handle,  Sheader) ; 

//  Exit  once  file  ends. 

if  (status  !=  I106_OK) { 
break; 

} 

//  Ensure  that  we're  interested  in  this  particular  packet. 

if  (args . exclude  &&  match (header . uChID,  args . exclude) ) { 
continue ; 

} 

else  if  (args . channel  &&  ! match (header . uChID,  args . channel )) { 
continue ; 

} 

else  if  (args. type  &&  ! match (header . ubyDataType,  args.type)){ 
continue ; 

} 


//  Increment  overall  size  and  packet  counts. 
byte_size  +=  header . ulPacketLen; 
packets++; 

//  Find  the  channel  info  based  on  ID  and  type, 
int  i  =  0; 

for  (i;  i  <  0x10000;  it!) { 

//  Create  a  listing  if  none  exists, 
if  (channels [i]  ==  NULL) { 

channels [i]  =  (ChanSpec  *)malloc(sizeof(ChanSpec)); 
memset (channels [i] ,  0,  sizeof(ChanSpec)); 
channels [ i ] ->id  =  (unsigned  int)header.uChID; 
channels [i] ->type  =  (unsigned  int) header .ubyDataType; 
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channels [ i ] ->packets  =  0; 

} 


if  ( channels [ i ] ->id  ==  (unsigned  int) header . uChID  &&  channels [i ] ->type  == 
(unsigned  int) header . ubyDataType) { 
break; 

} 


//  Increment  the  counter, 
channels [ i ] ->packets++  ; 


//  Print  details  for  each  channel. 

printf  ("Channel  ID  Data  Type%35sPackets\n", 

printf  (" - 

—  \n")  ; 
int  i  =  0; 

while  (channels [i]  !=  NULL) { 

printf  ("Channel%3d",  channels [ i ] ->id)  ; 
printf ("%6s",  ; 

printf  ("0x%-34x",  channels [ i ] ->type) ; 
printf ("%7d  packets",  channels [ i ] ->packets) ; 
printf ("\n") ; 
i  +  +  ; 

} 


//  Find  a  more  readable  size  unit  than  bytes, 
char  *unit  =  "b"; 
if  (byte_size  >  1024) { 
byte_size  /=  1024; 
unit  =  "kb"; 

} 

if  (byte_size  >  1024)  { 
byte_size  /=  1024; 
unit  =  "mb"; 

} 

if  (byte_size  >  1024) { 
byte_size  /=  1024; 
unit  =  "gb"; 

} 

//  Print  file  summary. 

printf (" - 

—  \n")  ; 

printf ("Summary  for  %s:\n",  argvfl]); 

printf  ("  Size:  %.*f%s\n",  2,  byte_size,  unit) ; 

printf  ("  Packets:  %d\n",  packets); 

printf  ("  Channels:  %d\n",  i); 

return  quit ( 0) ; 
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This  page  intentionally  left  blank. 
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Appendix  E 

Example  Python  Program  -  Display  Channel  Details 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  displays  channel 
ID  and  data  type  for  each  channel  as  well  as  a  count  of  how  many  packets  are  present  for  each 
channel  in  a  Chapter  10  file.  This  example  uses  the  Python  wrapper  to  the  irigl061ib  library. 

# ! /usr/bin/env  python 


stat.py  -  Display  some  basic  information  about  the  channels  within  a 
Chapter  10  file. 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


_ doc _  =  """usage:  stat.py  <file>  [options] 

Options : 

-c  CHANNEL...,  — channel  CHANNEL 
-e  CHANNEL...,  — exclude  CHANNEL 
-t  TYPE,  --type  TYPE 
be  decimal  or  hex  eg:  0x40) . """ 

from  contextlib  import  closing 

from  docopt  import  docopt 
from  Pyl06. Packet  import  10,  FileMode,  Status,  DataType 

from  walk  import  walk_packets 


Specify  channels  to  include (csv) . 
Specify  channels  to  ignore  (csv) . 

The  types  of  data  to  show  (csv,  may  \ 


E-l 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


if  _ name _ ==  ' _ main _ 

#  Get  commandline  args . 

args  =  docopt ( _ doc _ ) 

channels,  packets,  size  =  ([],  0,  0) 

#  Open  the  source  file, 
with  closing ( 10 () )  as  PktIO: 

RetStatus  =  PktIO. open (args [ '<file>' ] ,  FileMode .READ) 
if  RetStatus  !=  Status. OK: 

print  "Error  opening  data  file  %s"  %  args [ ' <f ile> ' ] 
raise  SystemExit 

#  Iterate  over  selected  packets  (based  on  args) . 

for  packet  in  walk_packets (PktIO . packet_headers ()  ,  args): 

#  Increment  overall  size  and  packet  count, 
size  +=  packet . PacketLen 

packets  +=  1 

#  Find  the  channel  info  based  on  ID  and  type. 
channel_index  =  None 

for  i,  channel  in  enumerate (channels) : 

if  channel [' id ' ]  ==  packet. ChID  and  \ 

channel [' type ' ]  ==  packet . DataType : 
channel_index  =  i 
break 

#  Find  the  channel  info  based  on  ID  and  type, 
if  channel_index  is  None: 

channel_index  =  len ( channels ) 
channels . append ({' packets ' :  0, 

'type':  packet . DataType, 

'id':  packet . ChID} ) 


#  Increment  the  counter. 

channels [channel_index] ['packets']  +=  1 

#  Print  details  for  each  channel . 

print (' Channel  ID  Data  Type'  +  ' Packets ' . r j ust ( 4 6 ) ) 

print  (  ' - '  *  80) 

for  channel  in  channels: 

dtype  =  DataType. name (channel [ 'type' ] ) 

print  (''. join  (((' Channel  %s '  %  channel [' id ']). lj ust ( 15 ) , 

('%s  -  %s '  %  (hex (channel [' type ']) ,  dtype) ). ljust (35) , 
('%s  packets'  %  channel [ 'packets ']). rjust (20) )) ) 

#  Find  a  more  readable  size  unit  than  bytes, 

units  =  [ ' gb ' ,  'mb',  'kb'] 

unit  =  'b' 

while  size  >  1024  and  units: 
size  /  =  1024.0 
unit  =  units. pop () 

#  Print  file  summary, 
print  (  ' - '  *  80) 

print (' Summary  for  %s:'  %  args [ ' <f ile> ' ] ) 

print  (  '  Size:  %s  %s '  %  (round(size,  2),  unit)) 

print  ('  Packets:  %s '  %  packets) 

print  (  '  Channels:  %s'  %  len (channels) ) 
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Appendix  F 

Example  Python  Program  -  Display  Channel  Details 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  displays  channel 
ID  and  data  type  for  each  channel  as  well  as  a  count  of  how  many  packets  are  present  for  each 
channel  in  a  chapter  10  file.  This  example  uses  the  PyChapterlO  library. 

# ! /usr/bin/env  python 


stat.py  -  Display  some  basic  information  about  the  channels  within  a 
Chapter  10  file. 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


_ doc _  =  """usage:  stat.py  <file>  [options] 

Options : 

-c  CHANNEL...,  --channel  CHANNEL...  Specify  channels  to  include ( csv) . 

-e  CHANNEL...,  --exclude  CHANNEL...  Specify  channels  to  ignore  (csv). 

-t  TYPE,  --type  TYPE  The  types  of  data  to  show  (csv,  may  \ 

be  decimal  or  hex  eg:  0x40) . """ 

from  docopt  import  docopt 

from  chapterlO  import  CIO 

from  chapterlO . datatypes  import  get_label 

from  walk  import  walk_packets 
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if  _ name _ ==  ' _ main _ 

#  Get  commandline  args . 

args  =  docopt ( _ doc _ ) 

channels,  packets,  size  =  ([],  0,  0) 

#  Open  the  source  file, 
src  =  CIO (args [' <file> '] ) 

#  Iterate  over  selected  packets  (based  on  args) . 
for  packet  in  walk_packets (src,  args) : 

#  Increment  overall  size  and  packet  count, 
size  +=  packet . packet_length 

packets  +=  1 

#  Find  the  channel  info  based  on  ID  and  type. 
channel_index  =  None 

for  i,  channel  in  enumerate ( channels )  : 

if  channel [' id ' ]  ==  packet . channel_id  and  \ 
channel [' type ' ]  ==  packet . data_type : 
channel_index  =  i 
break 

#  Create  a  listing  if  none  exists, 
if  channel_index  is  None: 

channel_index  =  len ( channels ) 
channels . append ({' packets ' :  0, 

'type':  packet . data_type, 
'id':  packet . channel_id} ) 


#  Increment  the  counter. 

channels [channel_index] ['packets']  +=  1 

#  Print  details  for  each  channel. 

print (' Channel  ID  Data  Type'  +  ' Packets ' . r j ust ( 4 6 ) ) 

print  (  ' - '  *  80 ) 

for  channel  in  channels: 

print  (''. join  (((' Channel  %s '  %  channel [' id ']). lj ust ( 15 )  , 

('%s  -  %s '  %  (hex (channel [' type ']) , 

get_label (channel [ ' type ' ] ) ) )  . 1 just  (35) , 
('%s  packets'  %  channel [ 'packets ']). rjust (20) )) ) 

#  Find  a  more  readable  size  unit  than  bytes, 

units  =  [ ' gb ' ,  'mb',  'kb'] 

unit  =  'b' 

while  size  >  1024  and  units: 
size  /  =  1024.0 
unit  =  units. pop () 

#  Print  file  summary, 
print  (  ' - '  *  80) 

print (' Summary  for  %s:'  %  args [ ' <f ile> ' ] ) 

print  (  '  Size:  %s  %s '  %  (round(size,  2),  unit)) 

print  ('  Packets:  %s '  %  packets) 

print  (  '  Channels:  %s'  %  len (channels) ) 
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Appendix  G 

Example  C  Program  -  Copy  Chapter  10  File 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  copies  its  data  to 
another  file  optionally  filtering  by  channel  ID  and/or  data  type. 


/* 


copy.c  -  Copy  all  or  part  of  a  Chapter  10  file  based  on  data  types,  channels, 
etc . 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 


*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 


This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


#include 

#include 

#include 

#include 


<stdio . h> 
<stdlib . h> 
<string . h> 
<stdint . h> 


#include  "irigl06chl0.h" 
#include  "copy_args . c" 
#include  "common. h" 


int  main(int  argc,  char  **  argv) { 

//  Get  commandline  args. 

DocoptArgs  args  =  docopt (argc,  argv,  1,  "1")  ; 
if  (argc  <  3)  { 


G-l 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


printf  (args . usage_pattern) ; 
return  quit ( 1 ) ; 


//  Open  input  and  output  files, 
int  input_handle ; 

EnI106Status  status  =  enI106ChlOOpen ( &input_handle,  argvfl],  I106_READ) ; 
if  (status  !=  I106_OK) { 

char  msg[200]  =  "Error  opening  source  file: 
strcat(msg,  argv[l]); 
return  error (msg) ; 

} 

FILE  *  output  =  fopen (argv [2 ] ,  "wb") ; 
if  (output  ==  NULL) { 

return  error ("Couldn ' t  open  destination  file."); 

} 


SuI106Chl0Header  header; 
void  *  buffer  =  malloc(24); 

//  Copy  TMATS 

status  =  enI106Chl0ReadNextHeader (input_handle,  Sheader) ; 
if  (status  !=  I106_OK) { 
printf ("Finished")  ; 
return  quit ( 0) ; 

} 

buffer  =  realloc (buffer,  header . ulPacketLen) ; 

status  =  enl 10 6Chl OReadDataFile ( input_handle,  header . ulPacketLen,  buffer); 
if  (status  !=  I106_OK) { 

printf  ("Error  reading  TMATS."); 
return  quit ( 0) ; 

} 

int  header_len  =  24; 

if  (header . ubyPacketFlags  &  (0x1  <<  7)  )  { 
header_len  =  36; 

} 

fwrite (Sheader,  header_len,  1,  output); 

fwrite  (buffer,  header . ulPacketLen  -  header_len,  1,  output); 

//  Iterate  over  packets  based  on  args. 
while  ( 1 )  { 

//  Read  next  header  or  exit. 

status  =  enl 10 6Chl OReadNextHeader ( input_handle,  Sheader) ; 
if  (status  !=  I106_OK) { 
printf ("Finished")  ; 
return  quit (0) ; 

} 

//  Ensure  that  we're  interested  in  this  particular  packet, 
if  (args . exclude  &&  match (header . uChID,  args . exclude) ) { 
continue ; 

} 

else  if  (args . channel  &&  ! match (header . uChID,  args . channel )) { 
continue ; 

} 

else  if  (args. type  &&  ! match (header . ubyDataType ,  args.type)){ 
continue ; 

} 


//  Copy  packet  to  new  file. 

buffer  =  realloc  (buffer,  header . ulPacketLen)  ; 

status  =  enl 10 6Chl OReadDataFile ( input_handle,  header . ulPacketLen,  buffer) 
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if  (status  !=  I106_OK) { 

printf ("Error  reading  packet."); 
continue ; 

} 

header_len  =  24; 

if  (header . ubyPacketFlags  &  (0x1  <<  7)){ 
header_len  =  36; 

} 

fwrite (&header,  header_len,  1,  output); 
fwrite (buffer,  header . ulPacketLen,  1,  output); 
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Appendix  H 

Example  Python  Program  -  Copy  Chapter  10  File 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  copies  its  data  to 
another  file  optionally  filtering  by  channel  ID  and/or  data  type.  This  sample  uses  the  Python 
wrapper  to  the  irig  1 061ib  C  library. 

# ! /usr/bin/env  python 


copy.py  -  Copy  all  or  part  of  a  Chapter  10  file  based  on  data  types, 
channels,  etc. 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


_ doc _  =  """usage:  copy.py  <src>  <dst> 

Options : 

-c  CHANNEL. . . ,  — channel  CHANNEL. . . 
-e  CHANNEL. . . ,  — exclude  CHANNEL. . . 
-t  TYPE,  --type  TYPE 
be  decimal  or  hex  eg:  0x40) 

-f  --force 

from  contextlib  import  closing 
import  os 


[options] 


Specify  channels  to  include  (csv) . 
Specify  channels  to  ignore  (csv) . 

The  types  of  data  to  copy  (csv,  may\ 

Overwrite  existing  files.""" 


from  docopt  import  docopt 
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from  Pyl06. Packet  import  10,  FileMode,  Status 
from  walk  import  walk_args 


if  _ name _ ==  ' _ main _ 

#  Get  commandline  args . 

args  =  docopt ( _ doc _ ) 

#  Don't  overwrite  unless  explicitly  required. 

if  os . path . exists (args [' <dst> '] )  and  not  args [ ' — force']: 
print ('dst  file  already  exists.  Use  -f  to  overwrite.') 
raise  SystemExit 

#  Open  input  and  output  files. 

with  open (args [' <dst> '] ,  'wb')  as  out,  closing ( 10  () )  as  PktIO: 

RetStatus  =  PktIO. open  (args [ '<src>' ] ,  FileMode . READ) 
if  RetStatus  !=  Status. OK: 

print  "Error  opening  data  file  %s"  %  args [  '  <src> '  ] 
raise  SystemExit 

#  Iterate  over  packets  based  on  args. 
channels,  exclude,  types  =  walk^args (args) 
i  =  0 

while  RetStatus  ==  Status. OK: 

RetStatus  =  PktIO. read_next_header ( ) 
if  i  >  1: 

if  PktIO . read_data ( )  !=  Status. OK: 

continue 

elif  channels  and  str  (PktIO. Header. ChID)  not  in  channels: 
continue 

elif  str  (PktIO . Header . ChID)  in  exclude: 
continue 

elif  types  and  PktIO . Header . DataType  not  in  types: 
continue 

#  Copy  packet  to  new  file, 
header  =  buffer (PktIO. Header ) [:] 

if  not  bool ( PktIO . Header . PacketFlags  &  (1  <<  7)  )  : 

header  =  header [: -12] 
out. write (header) 

ou t. write(PktIO.Buffer.r aw [: PktIO. Header . PacketLen  -  len (header) ] ) 
i  +=  1 
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Appendix  I 

Example  Python  Program  -  Copy  Chapter  10  File 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  copies  its  data  to 
another  file  optionally  filtering  by  channel  ID  and/or  data  type.  This  sample  uses  the 
PyChapterlO  library. 

# ! /usr/bin/env  python 


copy.py  -  Copy  all  or  part  of  a  Chapter  10  file  based  on  data  types, 
channels,  etc. 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


doc _  =  """usage:  copy.py  <src>  <dst>  [options] 


Options : 

-c  CHANNEL. . . ,  — channel  CHANNEL. . . 
-e  CHANNEL. . . ,  — exclude  CHANNEL. . . 
-t  TYPE,  --type  TYPE 
be  decimal  or  hex  eg:  0x40) 

-f  --force 

import  os 


Specify  channels  to  include  (csv) . 
Specify  channels  to  ignore  (csv) . 

The  types  of  data  to  copy  (csv,  may\ 

Overwrite  existing  files.""" 


from  chapterlO  import  CIO 
from  docopt  import  docopt 
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from  walk  import  walk_packets 


if  _ name _ ==  ' _ main _ 

#  Get  commandline  args . 

args  =  docopt ( _ doc _ ) 

#  Don't  overwrite  unless  explicitly  required. 

if  os . path . exists (args [' <dst> '] )  and  not  args [ ' — force']: 
print ('dst  file  already  exists.  Use  -f  to  overwrite.') 
raise  SystemExit 

#  Open  input  and  output  files. 

with  open (args [' <dst> '] ,  'wb')  as  out: 

src  =  CIO (args [ '<src>' ] ) 

#  Iterate  over  packets  based  on  args. 
for  packet  in  walk_packets (src,  args) : 

#  Copy  packet  to  new  file, 
raw  =  bytes (packet) 

if  len (raw)  ==  packet . packet_length : 
out . write ( raw) 
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Appendix  J 

Example  C  Program  -  Export  Chapter  10  Data 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  channel 
data  to  separate  files.  The  channels  may  be  filtered  by  ID  or  data  type. 


/* 


dump.c  -  Export  channel  data  based  on  channel  ID  or  data  type. 
Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 


*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 


This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


#include 

#include 

#include 

#include 

#include 


<stdio . h> 
<stdlib . h> 
<string . h> 
<stdint . h> 
<intr in . h> 


#include  "irigl06chl0.h" 
#include  "dump_args . c" 
#include  "common. h" 


//  Byteswap  a  buffer, 
void  swap (char  *p,  int  len)  { 
char  tmp; 

for  (int  i  =  0;  i  <  ((len  /  2));  i++)  { 

tmp  =  p [ i  *  2 ]  ; 
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p[i  *  2]  =  p [ (i  *  2)  +  1]  ; 

p [ ( i  *  2 )  +  1 ]  =  tmp ; 


int  main(int  argc,  char  **  argv) { 

DocoptArgs  args  =  docopt (argc,  argv,  1,  "1") ; 
int  input_handle ; 

SuI106Chl0Header  header; 
int  packets  =  0; 
char  *  buffer  =  malloc(24); 
char  *  ts  =  malloc(188); 

FILE  *out [0x10000] ; 

//  Initialize  out  to  NULLs, 
for  (int  i  =  0;  i  <  0x10000;  i++) { 
out [ i ]  =  NULL; 

} 


//  Validate  arguments  and  offer  help, 
if  (argc  <  2 ) { 

printf  (args . usage_pattern)  ; 
return  quit ( 1 ) ; 

} 


//  Open  file  for  reading. 

EnI106Status  status  =  enI106ChlOOpen (&input_handle,  argv[l],  I106_READ) 
if  (status  !=  I106_OK) { 

char  msg[200]  =  "Error  opening  source  file:  "; 
strcat(msg,  argv[l]); 
return  error (msg) ; 

} 


//  Parse  loop, 
while  ( 1 )  { 

//  Read  next  header  or  exit. 

status  =  enl 10 6Chl OReadNextHeader ( input_handle,  Sheader) ; 

if  (status  !=  I106_OK) { 
printf ("Finished")  ; 
return  quit (0) ; 

} 

//  Ensure  that  we're  interested  in  this  particular  packet. 

if  (args . exclude  &&  match (header . uChID,  args . exclude) ) { 
continue ; 

} 

else  if  (args . channel  &&  ! match (header . uChID,  args . channel )) { 
continue ; 

} 

else  if  (args. type  &&  ! match (header . ubyDataType,  args.type)){ 
continue ; 

} 


//  Get  the  correct  filename  for  this  channel. 

char  f ilename [ 10000 ] ; 

strcpy (filename,  args . output) ; 

char  channel [5]; 

sprintf ( channel ,  "/%d",  header . uChID)  ; 
strcat  ( filename,  channel); 

//  Check  for  video  (byte-swap  required) 
if  (0x3F  <  header . ubyDataType  <  0x43) { 
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strcat  ( filename,  ".mpg"); 

} 


//  Ensure  an  output  file  is  open  for  this  channel, 
if  (out [header . uChID]  ==  NULL) { 

out [header . uChID]  =  fopen ( filename,  "wb") ; 

if  (out [header . uChID]  ==  NULL) { 

printf ("Error  opening  output  file:  %s",  filename); 
return  quit ( 1 )  ; 


//  Read  packet  data. 

buffer  =  realloc  (buffer,  header . ulPacketLen) ; 

status  =  enl 10 6Chl OReadDataFile ( input_handle,  header . ulPacketLen, 
if  (status  !=  I106_OK) { 

printf  ("Error  reading  packet."); 
continue ; 

} 


//  Ignore  first  4  bytes  (CSDW) 

int  datalen  =  header . ulDataLen  -  4; 

if  (0x3F  <  header . ubyDataType  <  0x43) { 

for  (int  i  =  0;  i  <  (datalen  /  188);  i++) { 
memcpy(ts,  buffer  +  4  +  (i  *  188),  188); 
swap (ts,  188)  ; 

fwrite(ts,  1,  188,  out [header .uChID]); 


else  { 

fwrite  (buffer  +  4,  1,  datalen,  out [header . uChID] ) ; 

} 


return 

} 


quit ( 0) ; 
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Appendix  K 

Example  Python  Program  -  Export  Chapter  10  Data 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  channel 
data  to  separate  files.  The  channels  may  be  filtered  by  ID  or  data  type.  This  sample  uses  the 
Python  wrapper  to  the  irigl061ib  C  library. 

# ! /usr/bin/env  python 


dump.py  -  Export  channel  data  based  on  channel  ID  or  data  type. 
Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


doc _  =  """usage:  dump.py  <file>  [options] 


Options : 

-o  OUT,  — output  OUT 
[default :  . ] . 

-c  CHANNEL...,  — channel  CHANNEL 
-e  CHANNEL...,  — exclude  CHANNEL 
-t  TYPE,  --type  TYPE 
be  decimal  or  hex  eg:  0x40) 

-f,  — force 

from  array  import  array 
from  contextlib  import  closing 
import  atexit 
import  os 


The  directory  to  place  files  \ 

Specify  channels  to  include (csv) . 
Specify  channels  to  ignore  (csv) . 

The  types  of  data  to  export  (csv,  may\ 

Overwrite  existing  files.""" 
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from  docopt  import  docopt 

from  Pyl06. Packet  import  10,  FileMode,  Status 
from  walk  import  walk_args 


if  _ name _ ==  ' _ main _ 

args  =  docopt ( _ doc _ ) 

#  Ensure  OUT  exists. 

if  not  os . path . exists (args [ ' — output']): 
os .makedirs (args [ ' — output ' ] ) 

channels,  exclude,  types  =  walk^args (args) 

#  Open  input  file. 

with  closing  ( 10 () )  as  PktIO: 

RetStatus  =  PktIO. open  (args [ '<file>' ] ,  FileMode . READ) 
if  RetStatus  !=  Status. OK: 

print  "Error  opening  data  file  %s"  %  args [ ' <f ile> ' ] 
raise  SystemExit 


out  =  { } 

#  Iterate  over  packets  based  on  args. 
while  RetStatus  ==  Status. OK: 

RetStatus  =  PktIO. read_next_header ( ) 

if  channels  and  str ( PktIO . Header . ChID)  not  in  channels: 
continue 

elif  str (PktIO . Header . ChID)  in  exclude: 
continue 

elif  types  and  PktIO . Header . DataType  not  in  types: 
continue 

if  PktIO . read_data ( )  !=  Status. OK: 

continue 

#  Get  filename  for  this  channel  based  on  data  type. 

filename  =  os . path . j oin  (args [ ' — output'],  str (PktIO . Header . ChID) ) 
if  0x3F  <  PktIO . Header . DataType  <  0x43: 
filename  +=  '.mpg' 

#  Ensure  a  file  is  open  (and  will  close)  for  a  given  channel, 
if  filename  not  in  out: 

#  Don't  overwrite  unless  explicitly  required. 

if  os . path . exists ( filename)  and  not  args [' --force '] : 

print ('%s  already  exists.  Use  -f  to  overwrite.'  %  filename) 
break 

out [ filename ]  =  open (filename,  'wb') 
atexit . register (out [ filename] .close) 

data  =  PktIO . Buffer . raw [ 4 : PktIO . Header . PacketLen  -  4] 

#  Handle  special  case  for  video  data. 

if  bool(0x3F  <  PktIO . Header . DataType  <  0x43): 
for  i  in  range ( len (data)  /  188): 

body  =  array ( ' H ' ,  data[i  *  188:(i  +  1)  *  188]) 
body . byteswap ( ) 

out [ filename] .write (body. tostring ( ) ) 
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else : 

#  Write  out  raw  packet  body, 
out [filename] .write (data) 
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Appendix  L 

Example  Python  Program  -  Export  Chapter  10  Data 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  channel 
data  to  separate  files.  The  channels  may  be  filtered  by  ID  or  data  type.  This  sample  uses  the 
PyChapterlO  library. 

# ! /usr/bin/env  python 


dump.py  -  Export  channel  data  based  on  channel  ID  or  data  type. 
Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


doc _  =  """usage:  dump.py  <file>  [options] 


Options : 

-o  OUT,  — output  OUT 
[default :  . ] . 

-c  CHANNEL...,  — channel  CHANNEL 
-e  CHANNEL...,  — exclude  CHANNEL 
-t  TYPE,  --type  TYPE 
be  decimal  or  hex  eg:  0x40) 

-f,  — force 

import  atexit 
import  os 

from  chapterlO  import  CIO,  datatypes 
from  docopt  import  docopt 


The  directory  to  place  files  \ 

Specify  channels  to  include (csv) . 
Specify  channels  to  ignore  (csv) . 

The  types  of  data  to  export  (csv,  may\ 

Overwrite  existing  files.""" 
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from  walk  import  walk_packets 


if  _ name _ ==  ' _ main _ 

#  Get  commandline  args . 

args  =  docopt ( _ doc _ ) 

#  Ensure  OUT  exists. 

if  not  os . path . exists (args [ ' — output']): 
os .makedirs (args [ ' — output ' ] ) 

out  =  { } 

#  Iterate  over  packets  based  on  args. 

for  packet  in  walk_packets (CIO (args [' <file> '])  ,  args): 

#  Get  filename  for  this  channel  based  on  data  type. 

filename  =  os . path . j oin (args [ ' — output'],  str (packet . channel_id) ) 
t,  f  =  datatypes . format (packet . data_type) 
if  t  ==  0  and  f  ==  1 : 

filename  +=  packet .body. frmt  ==  0  and  '.tmats'  or  '.xml' 
elif  t  ==  8 : 

filename  t=  '.mpg' 

#  Ensure  a  file  is  open  (and  will  close)  for  a  given  channel, 
if  filename  not  in  out: 

#  Don't  overwrite  unless  explicitly  required. 

if  os . path . exists ( filename)  and  not  args [' --force '] : 

print('%s  already  exists.  Use  -f  to  overwrite.'  %  filename) 
break 

out [ filename ]  =  open (filename,  'wb') 
atexit . register (out [ filename] . close) 

#  Only  write  TMATS  once, 
elif  t  ==  0  and  f  ==  1 : 

continue 

#  Handle  special  case  for  video  data, 
if  t  ==  8: 

data  =  b ' ' . join ( [p.data  for  p  in  packet .body. mpeg] ) 
else : 

data  =  packet. body. data 

#  Write  out  raw  packet  body, 
out [filename] .write (data) 
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Appendix  M 

Example  C  Program  -  Reindex  Chapter  10  Files 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  its  content 
to  another  file  while  stripping  and  (optionally)  rebuilding  index  packets. 

/*========================================================================== 

reindex. c  -  Strip  and  (optionally)  rebuild  index  packets  for  a  Chapter  10 
file . 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 

****************************************************************************/ 

#include  <stdio.h> 

#include  <stdlib.h> 

#include  <string.h> 

#include  <stdint.h> 

#include  "irigl06chl0 . h" 

#include  "reindex_args . c" 

#include  "common. h" 

void  gen_node (int64_t  offset,  SuI106Chl0Header  *  packets,  int  packets_c,  int64_t 
offsets [],  FILE  *  output,  int  seq) { 

printf ("Index  node  for  %d  packets\n",  packets_c) ; 

//  Packet  header 
SuI106Chl0Header  index_header ; 
index_header . uSync  =  0xeb25; 
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index_header . uChID  =  0; 

index_header . ulPacketLen  =  36  +  (18  *  packets_c) ; 

index_header . ulDataLen  =  12  +  (18  *  packets_c) ; 

index_header . ubyHdrVer  =  0x06; 

index_header . ubySeqNum  =  seq; 

index_header . ubyPacketFlags  =  0; 

index^header . ubyDataType  =  0x03; 

index_header . uChecksum  =  0; 

uint64_t  sums  =  0xeb25  +  ((12  +  (18  *  packets_c) )  *  2); 
sums  +=24  +  6  +  seq  +  3; 
for  (int  i  =  0;  i  <=  6;  i++)  { 

sums  +=  index_header . aubyRef Time [ i ] ; 

} 

sums  &=  Oxffff; 

index_header . uChecksum  =  (uintl6_t) sums; 
fwrite (&index_header,  24,  1,  output); 

//  CSDW 

int32_t  csdw  =  0; 

csdw  &=  (1  <<  31); 

csdw  &=  (1  <<  30)  ; 

fwrite (&csdw,  4,  1,  output); 

//  File  size 

fwrite  (Soffset,  8,  1,  output); 

//  Packets 

for  (int  i  =  0;  i  <=  packets_c;  i++) { 

SuI106Chl0Header  packet  =  packets [i]  ; 

//  I PTS 

fwrite ( &index_header . aubyRef Time,  1,  6,  output); 

//  Index  entry 

int8_t  filler  =  0; 

fwrite (&filler,  1,  1,  output); 

fwrite  (Spacket.ubyDataType,  1,  1,  output); 

fwrite  (&packet.uChID,  2,  1,  output); 

fwrite  (&offsets [i] ,  8,  1,  output); 


int  increment ( seq)  { 
seq++; 

if  ( seq  >  OxFF) { 
seq  =  0; 

} 

return  seq; 


int  main (int  argc,  char  **  argv) { 

DocoptArgs  args  =  docopt (argc,  argv,  1,  "1")  ; 
int  input_handle ; 

SuI106Chl0Header  header; 
void  *  buffer  =  malloc(24); 

//  Validate  arguments  and  offer  help, 
if  (argc  <  3) { 

printf  (args . usage_pattern)  ; 
return  quit ( 1 ) ; 


//  Open  file  for  reading. 
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EnI106Status  status  =  enI106ChlOOpen ( &input_handle,  argv[l],  I106_READ) ; 
if  (status  !=  I106_OK) { 

char  msg[200]  =  "Error  opening  source  file: 
strcat (msg,  argv[l]); 
return  error (msg) ; 

} 


//  Open  output  file. 

FILE  *  output  =  fopen (argv [2 ] ,  "wb") ; 
if  (output  ==  NULL) { 

return  error ("Couldn ' t  open  destination  file."); 

} 


int  packets_c  =  0; 

SuI106Chl0Header  packets_arr [20000]  ; 
int64_t  of fsets [20000]  ; 

SuI106Chl0Header  last_packet; 

int  last_packet_at; 

int  node_seq  =  0; 

int64_t  offset; 

int  *hdrptr; 

int  hdrlen; 

//  Parse  loop, 
while  ( 1 )  { 

enI106Chl0GetPos (input_handle,  soffset)  ; 

//  Read  next  header  or  exit. 

status  =  enl 10 6Chl OReadNextHeader ( input_handle,  Sheader) ; 
if  (status  !=  I106_OK) { 
printf ("Finished")  ; 
return  quit (0) ; 

} 

//  Ensure  that  we're  interested  in  this  particular  packet, 
if  (header . ubyDataType  ==  0x3) { 
continue ; 

} 

//  Read  packet  data. 

buffer  =  realloc (buffer,  header . ulPacketLen) ; 

status  =  enl 10 6Chl OReadDataFile ( input_handle,  header . ulPacketLen,  buffer) 
if  (status  !=  I106_OK) { 

printf ("Error  reading  packet."); 
continue ; 

} 

if  (header . ubyDataType  !=  0x03) { 
hdrptr  =  Sheader; 

if  (header . ubyPacketFlags  &  (0x1  «  7)){ 
hdrlen  =  36; 


else  { 

hdrlen  =  24; 

} 


//  Write  packet  to  file. 

fwrite (hdrptr,  hdrlen,  1,  output); 

fwrite (buffer,  header . ulDataLen,  1,  output); 

last_packet  =  header; 

//enI106Chl0GetPos (input_handle,  &last_packet_at) ; 
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packets_c++; 

packets_arr [packets_c]  =  header; 

of f sets [packets_c]  =  offset  -  header . ulPacketLen; 


if  (args . strip) { 
continue ; 

} 

if  ( (header . ubyDataType  ==  0x02  | |  header . ubyDataType  ==  0x11)  | |  (packets_c  > 

20000) ){ 

//  Generate  node  packet. 

gen__node  (of f  set,  &packets_arr ,  packets_c,  offsets,  output,  node_seq) ; 
node_seq  =  increment (node_seq) ; 
packets_c  =  0; 

} 


if  (args . strip) { 

printf ("Stripped  existing  indices."); 

} 
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Appendix  N 

Example  Python  Program  -  Reindex  Chapter  10  Files 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  its  content 
to  another  file  while  stripping  and  (optionally)  rebuilding  index  packets.  This  sample  uses  the 
Python  wrapper  to  the  irigl061ib  C  library. 

# ! /usr/bin/env  python 


reindex. py  -  Strip  and  (optionally)  rebuild  index  packets  for  a  Chapter  10 
file . 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


_ doc _  =  """usage:  cl0_reindex.py  <src>  <dst>  [options] 

Options : 

-s,  --strip  Strip  existing  index  packets  and  exit, 
-f,  --force  Overwrite  existing  files.""" 

from  array  import  array 
from  contextlib  import  closing 
import  os 
import  struct 

from  docopt  import  docopt 

from  Pyl06. Packet  import  10,  FileMode,  Status 
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def  gen^node (packets,  seq=0) : 

"""Generate  an  index  node  packet.""" 

#  (rtc_low,  rtc_high,  channel_id,  datatype,  pos) 
print  'Index  node  for  %s  packets'  %  len (packets) 
packet  =  bytes  ( ) 

#  Header 

values  =  [0xeb25, 

0, 

24  +  4  +  (20  *  len (packets) ) , 

4  +  (20  *  len (packets) ) , 

0x06, 

seq, 

0, 

0x03]  +  list (packets [-1] [0] ) 

sums  =  struct . pack (' HHIIBBBBBBBBBB ' ,  ‘values) 
sums  =  sum (array (' H ' ,  sums))  &  Oxffff 
values . append ( sums ) 

packet  +=  struct . pack (' HHI IBBBBBBBBBBH ' ,  ‘values) 

#  CSDW 

csdw  =  0x0000 

csdw  &=  1  «  31 

csdw  &=  1  «  30 

csdw  +=  len (packets) 

packet  +=  struct .pack  (' I ' ,  csdw) 

#  File  Length  (at  start  of  node) 

pos  =  packets[-l] [-1]  +  packets[-l] [3] 
packet  +=  struct .pack (' Q ' ,  pos) 

#  Packets 

for  p  in  packets : 

ipts  =  struct . pack (' BBBBBB ' ,  *p[0]) 

index  =  struct . pack (' xHHQ ' ,  p[l],  p[2],  p  [  4 ] ) 

packet  +=  ipts  +  index 

return  pos,  packet 


def  gen_root (nodes,  last,  seq,  last_packet) : 
"""Generate  a  root  index  packet.""" 

print  'Root  index  for:  %s  nodes'  %  len (nodes) 

packet  =  bytes  ( ) 

#  Header 

values  =  [0xeb25, 

0, 

24+4+8+8+  (16  *  len (packets) ) , 
4  +  8  +  8  +  (16  *  len (packets) ) , 

0x06, 

seq, 

0, 

0x03]  +  list  (last_packet [0] ) 
sums  =  struct . pack (' HHIIBBBBBBBBBB ' ,  ‘values) 
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sums  =  sum (array (' H ' ,  sums))  &  Oxffff 
values . append ( sums ) 

packet  +=  struct . pack (' HHI IBBBBBBBBBBH ' ,  ‘values) 

#  CSDW 

csdw  =  0x0000 

csdw  &=  1  «  30 

csdw  +=  len (nodes) 

packet  +=  struct .pack (' I ' ,  csdw) 

#  File  Length  (at  start  of  node) 

pos  =  last_packet [-1]  +  last_packet [3] 
packet  +=  struct. pack( 'Q' ,  pos) 

#  Node  Packets 
for  node  in  nodes: 

ipts  =  struct . pack (' BBBBBB ' ,  *last_packet [ 0 ] ) 
offset  =  struct . pack (' Q ' ,  pos  -  node) 
packet  +=  ipts  +  offset 

if  last  is  None: 
last  =  pos 

packet  +=  struct. pack( 'Q' ,  last) 
return  pos,  packet 


def  increment ( seq) : 

"""Increment  the  sequence  number  or  reset  it. 

seq  +=  1 
if  seq  >  OxFF: 

seq  =  0 
return  seq 


if  _ name _ ==  ' _ main _ ': 

args  =  docopt ( _ doc _ ) 

#  Don't  overwrite  unless  explicitly  required, 
if  os . path . exists (args [' <dst> '] )  and  not  args [ ' — force']: 
print ('dst  file  already  exists.  Use  -f  to  overwrite.') 
raise  SystemExit 

with  open (args [' <dst> '] ,  'wb')  as  out,  closing ( 10 () )  as  io: 

status  =  io . open (args [' <src> '] ,  FileMode . READ) 
if  status  !=  Status. OK: 

print  "Error  opening  data  file  %s"  %  args [ ' <src> ' ] 
raise  SystemExit 

#  Packets  for  indexing, 
packets,  nodes  =  [],  [] 

node_seq  =  0 
last_root  =  None 
last_packet  =  None 

while  status  ==  Status. OK: 

status  =  io . read_next_header ( ) 
if  io . read_data ( )  !=  Status. OK: 

continue 

if  io . Header . DataType  ==  0x03: 
continue 
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header  =  buffer (io. Header) [:] 
out. write (header) 

raw  =  io . Buffer . raw [: io . Header . PacketLen  -  len(header)] 
out . write ( raw) 

#  Just  stripping  existing  indices  so  move  along, 
if  args [' --strip ' ] : 

continue 

#  (time,  channel_id,  data_type,  length,  pos) 
packet  =  ( io . Header . RefTime,  io . Header . Time [1 ] , 

io . Header . ChID,  io . Header . DataType,  io . Header . DataLen , 
io . get_pos ( ) [1 ]  -  io . Header . PacketLen) 
packets . append (packet) 
last_packet  =  packet 

#  Projected  index  node  packet  size, 
size  =  24  +  4  +  (20  *  len (packets )  ) 

if  io . Header . DataType  in  (0x02,  0x11)  or  size  >  524000: 
offset,  raw  =  gen_node (packets) 
nodes . append (offset) 
out . write ( raw) 
packets  =  [] 

#  Projected  root  index  packet  size, 
size  =  24  +  4  +  (16  *  len(nodes))  +  16 
if  size  >  524000: 

last_root,  raw  =  gen_root (nodes ,  last_root,  node_seq, 

last_packet) 

out . write ( raw) 

node_seq  =  increment (node_seq) 
nodes  =  [] 

#  Final  indices, 
if  packets: 

offset,  raw  =  gen_node (packets ) 
nodes . append  (offset) 
out . write ( raw) 
if  nodes: 

last_root,  raw  =  gen^root (nodes,  last_root,  node_seq,  last^packet) 
out . write ( raw) 

if  args [' --strip '] : 

print  'Stripped  existing  indices.' 


N-4 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


Appendix  O 

Example  Python  Program  -  Reindex  Chapter  10  Files 

The  following  software  program  opens  a  Chapter  10  file  for  reading  and  writes  its  content 
to  another  file  while  stripping  and  (optionally)  rebuilding  index  packets.  This  sample  uses  the 
PyChapterlO  library. 

# ! /usr/bin/env  python 

reindex. py  -  Strip  and  (optionally)  rebuild  index  packets  for  a  Chapter  10 
file . 

Copyright  (c)  2015  Micah  Ferrill 
All  rights  reserved. 

Redistribution  and  use  in  source  and  binary  forms,  with  or  without 
modification,  are  permitted  provided  that  the  following  conditions  are 
met : 

*  Redistributions  of  source  code  must  retain  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer. 

*  Redistributions  in  binary  form  must  reproduce  the  above  copyright 
notice,  this  list  of  conditions  and  the  following  disclaimer  in  the 
documentation  and/or  other  materials  provided  with  the  distribution. 

*  Neither  the  name  Irigl06.org  nor  the  names  of  its  contributors  may 
be  used  to  endorse  or  promote  products  derived  from  this  software 
without  specific  prior  written  permission. 

This  software  is  provided  by  the  copyright  holders  and  contributors 
"as  is"  and  any  express  or  implied  warranties,  including,  but  not 
limited  to,  the  implied  warranties  of  merchantability  and  fitness  for 
a  particular  purpose  are  disclaimed.  In  no  event  shall  the  copyright 
owner  or  contributors  be  liable  for  any  direct,  indirect,  incidental, 
special,  exemplary,  or  consequential  damages  (including,  but  not 
limited  to,  procurement  of  substitute  goods  or  services;  loss  of  use, 
data,  or  profits;  or  business  interruption)  however  caused  and  on  any 
theory  of  liability,  whether  in  contract,  strict  liability,  or  tort 
(including  negligence  or  otherwise)  arising  in  any  way  out  of  the  use 
of  this  software,  even  if  advised  of  the  possibility  of  such  damage. 


_ doc _  =  """usage:  reindex. py  <src>  <dst>  [options] 

Options : 

-s,  --strip  Strip  existing  index  packets  and  exit, 
-f,  --force  Overwrite  existing  files.""" 

from  array  import  array 
import  os 
import  struct 

from  docopt  import  docopt 

from  chapterlO  import  CIO 
from  walk  import  walk_packets 
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def  gen^node (packets,  seq=0) : 

"""Generate  an  index  node  packet.""" 

print  'Index  node  for  %s  packets'  %  len (packets) 

packet  =  bytes ( ) 

#  Header 

values  =  [0xeb25, 

0, 

24  +  4  +  8  +  (20  *  len (packets) ) , 

4  +  8  +  (20  *  len (packets) ) , 

0x06, 

seq, 

0, 

0x03, 

packets [-1] . rtc_low, 
packets [-1] . rtc_high] 

sums  =  struct . pack  (' HHIIBBBBIH ' ,  ‘values) 
sums  =  sum (array (' H ' ,  sums))  &  Oxffff 
values . append ( sums ) 

packet  +=  struct . pack (' HHI IBBBBIHH ' ,  ‘values) 

#  CSDW 

csdw  =  0x0000 

csdw  &=  1  «  31 

csdw  &=  1  «  30 

csdw  +=  len (packets) 

packet  +=  struct .pack  (' I ' ,  csdw) 

#  File  Length  (at  start  of  node) 

pos  =  packets [-1] .pos  +  packets [-1] . packet_length 
packet  +=  struct .pack (' Q ' ,  pos) 

#  Packets 

for  p  in  packets : 

ipts  =  struct . pack  (' HH ' ,  p.rtc_low  &  Oxffff,  p.rtc_high  &  Oxffff) 
index  =  struct . pack (' xHHQ ' ,  p . channel_id,  p.data_type,  p.pos) 
packet  +=  ipts  +  index 

return  pos,  packet 


def  gen_root (nodes,  last,  seq,  last_packet) : 
"""Generate  a  root  index  packet.""" 

print  'Root  index  for:  %s  nodes'  %  len (nodes) 

packet  =  bytes ( ) 

#  Header 

values  =  [0xeb25, 

0, 

24+4+8+8+  (16  *  len (packets) ) , 
4  +  8  +  8  +  (16  *  len (packets) ) , 

0x06, 

seq, 

0, 

0x03, 

last_packet . rtc_low. 
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last_packet . rtc_high] 

sums  =  struct . pack (' HHIIBBBBIH ' ,  ‘values) 
sums  =  sum (array (' H ' ,  sums))  &  Oxffff 
values . append ( sums ) 

packet  +=  struct . pack (' HHI IBBBBIHH ' ,  ‘values) 

#  CSDW 

csdw  =  0x0000 

csdw  &=  1  «  30 

csdw  +=  len (nodes) 

packet  +=  struct .pack (' I ' ,  csdw) 

#  File  Length  (at  start  of  node) 

pos  =  last_packet . pos  +  last_packet . packet_length 
packet  +=  struct. pack( 'Q' ,  pos) 

#  Node  Packets 
for  node  in  nodes: 

ipts  =  struct . pack  (' HH ' ,  last_packet . rtc_low  &  Oxffff, 
last_packet . rtc_high  &  Oxffff) 
offset  =  struct . pack (' Q ' ,  pos  -  node) 
packet  +=  ipts  +  offset 

if  last  is  None: 

last  =  last_packet .pos  +  last_packet ,packet_length 
packet  +=  struct. pack( 'Q' ,  last) 

return  pos,  packet 


def  increment ( seq) : 

"""Increment  the  sequence  number  or  reset  it. 

seq  +=  1 
if  seq  >  OxFF: 

seq  =  0 
return  seq 


if  _ name _ ==  ' _ main _ ': 

args  =  docopt ( _ doc _ ) 

#  Don't  overwrite  unless  explicitly  required, 
if  os . path . exists (args [' <dst> '] )  and  not  args [ ' — force']: 
print ('dst  file  already  exists.  Use  -f  to  overwrite.') 
raise  SystemExit 

with  open (args [' <dst> '] ,  'wb')  as  out: 

#  Packets  for  indexing, 
packets,  nodes  =  [],  [] 

node_seq  =  0 
last_root  =  None 
last_packet  =  None 

for  packet  in  walk_packets (CIO (args [' <src> ']) ,  args): 
last_packet  =  packet 
if  packet . data_type  ==  0x03: 
continue 

raw  =  bytes (packet) 

if  len  (raw)  ==  packet . packet_length : 
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out . write ( raw) 

#  Just  stripping  existing  indices  so  move  along, 
if  args [' --strip ']  : 

continue 

packets . append (packet) 

#  Projected  index  node  packet  size, 
size  =  24  +  4  +  8  +  (20  *  len (packets )  ) 

if  packet . data_type  in  (0x02,  0x11)  or  size  >  524000: 
offset,  raw  =  gen__node  (packets,  node_seq) 
node_seq  =  increment (node_seq) 
nodes . append (offset) 
out . write ( raw) 
packets  =  [] 

#  Projected  root  index  packet  size, 
size  =  24  +  4  +  (16  *  len(nodes))  +  16 
if  size  >  524000: 

last_root,  raw  =  gen_root (nodes ,  last_root,  node_seq, 

last_packet) 

out . write ( raw) 

node_seq  =  increment (node_seq) 
nodes  =  [] 

#  Final  indices, 
if  packets: 

offset,  raw  =  gen_node (packets ) 
nodes . append  (offset) 
out . write ( raw) 
if  nodes: 

offset,  raw  =  gen^root (nodes ,  last_root,  node_seq,  last_packet) 
out . write ( raw) 

if  args [' --strip '] : 

pr int (' Stripped  existing  indices.') 
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Appendix  P 
XML  Mapping 


P.l  Introduction 

This  specification  is  a  reply  to  the  RCC  change  request  CR03 1 . 

The  intention  of  this  specification  is  to  have  a  way  to  define  IRIG  106  Chapter  10  files 
for  testing  purposes  in  a  readable  XML  format.  This  would  allow  tools  to  convert  between  XML 
and  CH10  back  and  forth.  The  focus  of  XML  is  readability  and  not  memory  efficiency  or 
processing  efficiency.  Therefore  the  area  of  application  for  this  specification  is  the  generation  of 
smaller  test  files  (although  nothing  technically  prevents  having  large  files). 

The  conversion  from  XML  to  CH10  opens  these  opportunities  for  example: 

•  Setup  of  test  data  for  the  verification  of  CH10  analysis  software; 

•  Preparation  of  exactly  specified  data  sets  for  replay. 

The  conversion  from  CH10  to  XML  opens  these  opportunities  for  example: 

•  CH10  files  (for  example  from  recorders  under  development)  could  be  converted 
to  XML  for  closer  inspection  and  to  verify  possible  corrections  (by  converting  the 
manually  corrected  XML  file  back  to  CH10); 

•  Specific  error  cases  can  be  created  for  test  cases  by  converting  real  files  to  XML, 
injecting  the  error  and  converting  back  for  replay. 

P.2  Changes 

See  the  XML  schema  document  (XSD)  file  for  a  brief  change  history. 

P.3  Concepts 

This  specification  provides  an  XML  schema  that  defines  many  but  not  all  restrictions  for 
valid  files.  Having  validated  XML  files  is  the  precondition  to  any  further  conversion. 

The  XML  files  will  basically  be  a  sequence  of  CH10  packets,  each  defined  within  one 
XML  Packet  tag. 

Within  one  Packet  tag,  optional  secondary  headers  and  data  type  specific  content  can  be 

placed. 

P.3.1  Raw  data 

Many  places  in  the  file  allow  the  placement  of  raw  data,  for  example  for  the  creation  of 
undefined  packet  types  or  to  create  errors.  If  anything  cannot  be  defined  in  a  structured  way  by 
the  use  of  XML  tags  and  attributes,  it  can  still  be  defined  by  defining  the  raw  data  directly. 

P.3.2  Endianness 

CH10  files  use  little  endian  to  encode  attributes  spanning  over  several  bytes.  Therefore  a 
checksum  attribute  defined  as  0x12345678  shall  be  stored  in  the  byte  order  78  56  34  12.  If  any 
of  the  XML  attributes  separates  the  data  in  groups  however,  then  little  endian  byte  order  shall 
only  be  used  within  each  group.  For  example  if  some  raw  data  is  defined  as  16-bit  hex  words 
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like  “1234  5678”,  then  the  data  shall  be  stored  in  the  order  34  12  78  56  because  the  values  form 
two  groups  and  little  endian  only  applies  within  the  group  1234  and  the  group  5678. 

P.3.3  Auto  values 

Often  attributes  offer  “auto-values”.  This  means  that  the  user  is  not  providing  these 
values  but  the  conversion  tool  is  supposed  to  do  this.  Often  there  will  be  three  options: 

•  Automatic  calculation  by  conversion  tool 

•  Automatic  calculation  by  conversion  tool,  modified  somehow  by  users  choice 
(offset) 

•  Fixed  value  (user  provided  content) 

An  example  would  be  a  checksum  value,  for  which  following  situations  could  occur 

•  The  user  omitted  the  value:  The  calculation  will  be  automatic 

•  The  user  provided  a  relative  value  like  +5  or  -12:  The  result  of  the  automatic 
calculation  will  be  modified  by  +5  or  -12  to  create  an  invalid  checksum. 

•  The  user  provided  a  fixed  value:  The  fixed  value  will  be  used 

Auto-values  require  an  explicit  definition  of  what  they  relate  to.  An  auto-value  that  is 
calculating  the  number  of  MIL-STD  1553  messages  within  one  packet  for  example  requires 
explicit  definition  of  the  MIL-STD  1553  messages  via  XML  tags.  Definitions  via  a  block  of  raw 
data  will  not  count. 

If  you  use  a  fixed  value  somewhere  remember  you  need  to  update  it  manually  when  you 
change  other  data. 

P.3.4  Hexadecimal  vs  decimal 

There  are  attributes  that  require  the  data  to  be  defined  in  hexadecimal  and  others  that 
require  decimal  data.  Most  attributes  accept  both.  In  this  case,  hexadecimal  data  shall  be 
prefixed  by  “Ox”. 

P.3.5  Flag  words 

Data  structures  like  flag  words  (like  packet  flags  or  CSDW)  will  be  available  to  define  as 
a  whole  or  with  its  sub  elements.  In  general  the  definition  for  the  flag  word  will  be  used  as  a 
base  that  is  then  bitwise  modified  by  the  more  specific  sub  elements  within  the  flag  word  that  are 
explicitly  defined  in  XML. 

Example: 

PacketFlags=“0xC4”  RTCSyncError=“True” 


The  packet  flags  of  0xC4  indicate  that  secondary  headers  are  present  and  used  as 
IEEE1588  intra-packet  time.  The  RTCSyncError  additionally  sets  the  bit  to  indicate  an  RTC 
sync  error  so  the  stored  flag  word  becomes  0xE4. 

P.3.6  RTC 

Packet  RTCs  have  several  options  to  define  which  are  described  in  the  XSD  file.  Here 
some  examples: 


P-2 


IRIG  106  Chapter  10  Programmers’  Handbook  RCC  123-16  August  2016 


1234 

RTC  =  1234 

OxFF 

RTC  =  255 

p  +  120 

RTC  is  120  ticks  behind  the  previous  packet 

c  +  120 

RTC  is  120  ticks  behind  the  previous  packet  on  the  same  channel 

P.3.7  Channel  defaults 

You  can  define  default  values  for  packet  flags,  data  type  and  data  type  version  per 
channel.  You  can  also  change  these  defaults  at  different  places  in  the  file.  You  can  override  this 
in  individual  packets 

P.3.8  Various 

All  data  that  is  not  further  specified  shall  be  0. 

Some  attributes  just  have  one  possible  value.  For  example  the  RTCSyncError  from  the 
previous  example  can  just  be  “true”.  Instead  of  setting  it  to  false,  the  attribute  must  be  omitted. 

The  XML  schema  (XSD  file)  contains  some  additional  documentation  for  some  elements. 

P.4  Specific  data  types 

P.4.1  TMATS 

The  TMATS  data  can  be  provided  directly  or  as  include  file. 

If  you  directly  provide  TMATS  data  you  can  use  the  ASCII  tag.  Note  that  you  must 
make  sure  that  the  characters  you  use  do  not  conflict  with  the  XML  syntax.  Also  as  a  result  of 
the  XML  specification  itself  all  line  breaks  will  be  converted  to  a  single  line  feed  (ASCII  code 
0x0 A).  Also  XML  prohibits  the  0x00  ASCII  code  inside  the  data. 

P.4.2  Time 

Time  packets  can  be  either  defined  relative  to  the  last  time  packet  or  you  can  provide  an 
absolute  time  definition. 

P.4.3  Real  data  types 

Currently  ARINC  429,  MIL-STD  1553,  UART,  and  CAN  bus  data  can  be  defined  in  a 
structured  way.  Other  data  types  can  always  be  provided  as  raw  data  inside  the  packet. 

P.5  Sample  files 


There  are  seven  sample  files  in  XML  and  converted  CH10  format. 


Arinc429/Mil  1 5  5  3/UART 

These  show  how  data  for  ARINC  429,  MIL-STD- 1553,  and 
UART  can  be  defined  in  a  structured  way. 

CANBus 

Demonstrates  how  data  can  be  defined  as  raw  data  if  the  data 
type  is  not  yet  supported  by  XML.  The  same  CAN  bus  data  is 
defined  as: 

•  Raw  data 

•  Structured  definition 

•  Definition  in  DATaRec4  format  (Zodiac  Data  systems 
CH10  extension) 
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NMEA0183 

Shows  an  NMEA  0183  GPS  definition  using  structured  UART 
message  definition. 

RTCWrap 

Shows  how  specific  elements  of  packet  decoding  can  be  tested. 
Here  the  RTC  wraps  from  the  highest  value  to  0  and  you  can 
check  how  your  CH10  software  reacts  on  it  (this  is  no 
unrealistic  case  since  RTC  has  no  defined  starting  value). 

mappingF  eatures 

Shows  many  other  features  of  the  XML  to  CH10  mapping.  The 
created  file  contains  a  lot  of  intentional  errors  like  arbitrary  data 
inserted  between  packets,  checksum  and  sequence  errors,  etc. 

It  also  shows  things  like  relative  packet  time  definition  and 
other  concepts  explained  above. 

This  sample  uses  an  external  TMATS  file.  You  must  download 
it  and  place  it  in  the  same  directory  or  adapt  the  path. 
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Appendix  Q 

XML  schema  definition  (XSD) 

<?xml  version=" 1 . 0 "  encoding="UTF-8 " ?> 

<xs : schema  xml ns : xs="http : / /www . w3 . org/2 001 /XML Schema" 
targetNamespace="http : / / www . example . org/XMLCHlOMapping" 

xmlns : cns="http : / /www . example . org/XMLCHl OMapping"  element FormDefault="qualif ied"> 
<!--  This  proposed  specification  has  the  internal  version  number  0.3.1. 

History: 

Version  0.3.1 

-  for  automatic  Arinc  429  parity  handling  changed  within  ARINC42 9MessageType : 

-  renamed  Data  attribute  to  Raw32 

-  added  Raw31  attribute 

-  added  GenerateWrongParity  attribute 

Version  0.3: 

-  added  IRIG  106-2015  version  flags 

-  added  CAN  Bus  definition 

Version  0.2: 

-  renamed  all  CRC  to  checksum 

-  data  CRC  now  requires  Ox  prefix 

-  Raw  time  definition  in  secondary  headers 

--> 


<xs: element  name="chl0"> 

<xs : complexType> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 

<xs:element  name="Packet"  type="cns : PacketType"/> 
<xs : element  name=" Channel Defaults " 

type="cns : ChannelDefaultsType"/> 

<xs : group  ref ="cns : RawDataGroup"/> 

</ xs : choice> 

</xs : sequence> 

</ xs : complexType> 

</ xs : element> 


<!--  Packet  Header  /  Trailer  --> 

<xs : complexType  name="PacketType"> 

<xs: sequence  minOccurs="0"> 

<xs : element  name="SecondaryHeader "  type="cns : SecondaryHeaderType" 

minOccurs="0"/> 


<xs: choice  minOccurs="0"> 

<xs:group  ref="cns : RawDataGroup"  minOccurs="0" 

maxOccur s="unbounded"  /> 


<xs : element 
<xs : element 
<xs : element 

type="cns : ARINC429DataType"/> 

<xs : element 
<xs : element 
<xs : element 
</ xs : choice> 

</ xs : sequence> 


name="UARTData"  type="cns : UARTDataType" /> 
name="Mill553Data"  type="cns :Mill553DataType"/> 
name="ARINC42  9Data" 

name="CANBusData"  type="cns : CANBusDataType" /> 
name="TMATSData"  type="cns : TMATSDataType"/> 
name="TimeData"  type="cns : TimeDataType" /> 


< ! --  Header  --> 

<xs : attribute  name="ChannelID"  type="cns : U1 6HexDec"  use="required"/> 
<xs : attribute  name="RTC"  type="cns : PacketRTCType"  use="required"/> 
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<xs : attribute  name=" Packet SyncPat tern"  type="cns : U1 6HexDec" /> 

<xs : attribute  name="PacketLength"  type="cns :RelativeU32HexDec"> 

<xs  :  annotationXxs  :  documentation>If  this  attribute  is  not  used, 
the  proper  length  is  calculated.  If  it  contains  an  unsigned  number  this  is  used  as  a 
fixed  value.  Any  signed  numbers  (including  positive  sign)  will  be  used  to  manipulate 
the  proper  length  calculation.  The  number  itself  can  start  with  Ox  for  hex 
values</ xs  :  documentationx/xs  :  annotation> 

</xs : attribute> 

<xs : attribute  name=" DataLength"  type="cns : RelativeU32HexDec"> 

<xs  :  annotationXxs  :  documentation>If  this  attribute  is  not  used, 
the  proper  length  is  calculated.  If  it  contains  an  unsigned  number  this  is  used  as  a 
fixed  value.  Any  signed  numbers  (including  positive  sign)  will  be  used  to  manipulate 
the  proper  length  calculation.  The  number  itself  can  start  with  Ox  for  hex 
values</xs:  documentationx/xs  :  anno  tat  ion  > 

</xs : attribute> 

<xs : attr ibuteGroup  ref="cns : dataTypeVersionDefinition"/> 

<xs : attribute  name="SequenceNumber"  type="cns :RelativeU8HexDec"> 

<xs  :  annotationXxs  :  documentation>If  this  attribute  is  not  used, 
the  proper  sequence  number  is  calculated.  If  it  contains  an  unsigned  number  this  is 
used  as  a  fixed  value.  Any  signed  numbers  (including  positive  sign)  will  be  used  to 
manipulate  the  proper  sequence  calculation.  The  number  itself  can  start  with  Ox  for 
hex  values</xs:  documentationx/xs  :  anno  tat  ion  > 

</xs : attribute> 

<xs : attributeGroup  ref="cns :packetFlagsDefinition"/> 

<xs : attributeGroup  ref ="cns : dataTypeDef in it ion" /> 

<xs : attribute  name=" Header Check sum"  type="cns : RelativeUl 6HexDec"> 

<xs : annotationXxs : documentation>if  absent  automatic,  otherwise 
the  hex  value  is  used  as  checksum.  If  there  is  a  sign  in  front  (+/-)  it  is  used  as  an 
offset  to  the  calculated  checksum.  The  number  itself  can  start  with  Ox  for  hex 
values</xs:  documentationx/xs  :  anno  tat  ion  > 

</xs : attribute> 

<!--  Trailer  --> 

<xs : attr ibute  name="Filler"  type="cns : HexBytesType"> 

<xs : annotationXxs : documentation>if  absent  automatic,  otherwise 
adds  as  many  bytes  as  hex  values  are  available</xs : documentationx/xs : annotation> 

</xs : attribute> 

<xs : attribute  name="DataChecksum"  type="cns : ChecksumType"> 

<xs : annotationXxs : documentation>if  absent  automatic,  otherwise 
adds  as  many  bytes  as  hex  values  are  available  (add  leading  0  to  identify  number  of 
bytes) .  The  data  will  be  added  in  little  endian  order,  values  with  a  sign  are 
interpreted  as  offset  for  the  automatic  calculation  and  will  use  the  number  of  bytes 
defined  in  the  packet  flags</xs : documentationx/xs : annotation> 

</xs : attribute> 

</ xs : complexType> 

<xs : simpleType  name="ChecksumType"> 

<xs : restriction  base="xs : string"> 

<xs : pattern  value=" [\+\— ] ? ( ( [0—9] +) I (Ox [0-9a-fA- 

F]  +  )  )  "x/xs  : patter n> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="PacketRTCType"> 

<xs : annotation> 

<xs : documentation> 
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Absolute  or  relative  RTC  values.  Absolute  values  are  simple 
unsigned  integers.  Values  starting  with  p  are  relative  to  the  last  packet,  values 
starting  with  c  are  relative  to  previous  packet  on  same  channel .  The  second  character 
must  then  be  a  sign  to  indicate  the  direction  of  the  following  offset.  Relative  and 
absolute  values  can  start  with  Ox  right  before  the  first  digit  to  indicate  hex  values 
</xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs: pattern  value=" ( (c\  +  )  I  ( c\  — )  |  (p\  +  )  |  (p\  — ))?(([ 0  —  9 ]  {1,15})  |  (0x[0- 
9a-f A-F] { 1 , 12 } ) ) "></xs :pattern> 

</xs:restriction> 

</xs : simpleType> 


<xs : simpleType  name="DataTypeType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="UART  Format  0"/> 

<xs : enumeration  value="1553  Format  l"/> 

<xs : enumeration  value="ARINC-42 9  Format  0"/> 
<xs : enumeration  value="Time  Format  l"/> 

<xs : enumeration  value="TMATS"/> 

<xs : enumeration  value="CAN  Bus"/> 
</xs:restriction> 

</xs : simpleType> 

<xs : simpleType  name="DataTypeVersionType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value=" 10 6-04 "/> 

<xs : enumeration  value=" 10  6-05 "/> 

<xs : enumeration  value=" 10 6-07 "/> 

<xs : enumeration  value=" 10 6-09 "/> 

<xs : enumeration  value=" 10 6-11 "/> 

<xs : enumeration  value=" 10 6-13 "/> 

<xs : enumeration  value=" 10 6-15 "/> 
</xs:restriction> 

</xs : simpleType> 

<xs : simpleType  name="SecondaryHeaderTimeFormatType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="Chapter  4  Binary"/> 
<xs : enumeration  value="IEEE  1588"/> 

<xs : enumeration  value="ERTC"/> 

<xs : enumeration  value="Reserved"/> 
</xs:restriction> 

</xs : simpleType> 

<xs : simpleType  name="ChecksumTypeType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="ChecksumO"/> 

<xs : enumeration  value="Checksum8"/> 

<xs : enumeration  value="Checksuml6"/> 

<xs : enumeration  value="Checksum32 "/> 
</xs:restriction> 

</ xs : simpleType> 


<!--  Secondary  headers  --> 

<xs : complexType  name="SecondaryHeaderType"> 

<xs : attributeGroup  ref="cns : secondaryHeaderTimeDefinition"/> 
<xs : attribute  name="Filler"  type="cns : HexBytesType" /> 

<xs : attribute  name=" Checks urn"  type="cns : RelativeUl 6HexDec"/> 
</ xs : complexType> 

<!--  Time  packets  --> 

<xs : complexType  name="TimeDataType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 
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<xs : element  name="TimeDataRelativeContent" 
type="cns : TimeDataRelativeContentType"  /> 

<xs : element  name="TimeDataContent" 
type="cns : TimeDataContentType"  /> 

<xs: group  ref="cns : RawDataGroup"  /> 

</xs : choice> 

</ xs : sequence> 

<xs : attribute  name="MonthYearAvailable"  type="cns : TrueType"  /> 

<xs : attribute  name="LeapYear "  type="cns : TrueType"  /> 

<xs : attribute  name="TimeFormat"  type="cns : TimeDataTimeFormatType"  /> 

<xs : attribute  name="TimeSource"  type="cns : TimeDataTimeSourceType"  /> 

<xs : attribute  name="CSDW"  type="cns :U32HexDec"  /> 

</ xs : complexType> 

<xs : complexType  name="TimeDataContentType"> 

<xs : attribute  name="msec"  type="xs : unsignedShort"  use="optional "  /> 

<xs : attribute  name="sec"  type="xs : unsignedByte"  use="required"  /> 

<xs : attribute  name="min"  type="xs : unsignedByte"  use="required"  /> 

<xs : attribute  name="hrs"  type="xs : unsignedByte"  use="required"  /> 

<xs : attribute  name="day"  type="xs : unsignedShort"  use="required"  /> 

<xs : attribute  name="mth"  type="xs : unsignedByte"  use="optional "  /> 

<xs : attribute  name="year"  type="xs : unsignedShort"  use="optional "  /> 

</ xs : complexType> 

<xs : complexType  name="TimeDataRelativeContentType"> 

<xs : attribute  name="Of f setMs"  type="xs : long"  use="required"> 

<xs : annotation> 

<xs : documentation> 

Offset  to  last  properly  defined  time  packet  on  same 

channel  in  milliseconds. 

This  may  wrap  the  year  respecting  the  LeapYear 
attribute  definition  or  CSDW  flag  of  the  last  properly  defined  time  packet 

on  the  same  channel.  Even  if  the  year  is  wrapping  the 
leap  year  attribute  shall  not  be  altered  for  this  packet  but  use  defined  state. 

</xs : documentation> 

</ xs : annotation> 

</xs : attribute> 

</ xs : complexType> 

<xs : simpleType  name="TimeDataTimeFormatType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="IRIG  B"  /> 

<xs : enumeration  value="IRIG  A"  /> 

<xs : enumeration  value="IRIG  G"  /> 

<xs : enumeration  value=" Internal "  /> 

<xs : enumeration  value="UTC  Time  From  GPS"  /> 

<xs : enumeration  value="Native  GPS  Time"  /> 

<xs : enumeration  value="None"  /> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="TimeDataTimeSourceType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value=" Internal "  /> 

<xs : enumeration  value="External "  /> 

<xs : enumeration  value=" Internal  From  RMM"  /> 

<xs : enumeration  value="None"  /> 

</xs:restriction> 

</ xs : simpleType> 

<xs : complexType  name="ChannelDefaultsType"> 

<xs : attribute  name="ChannelID"  type="cns : U1 6HexDec"  use="required"/> 

<xs : attributeGroup  ref="cns :packetFlagsDefinition"/> 
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<xs : attr ibuteGroup  ref ="cns : dataTypeDef in it ion" /> 

<xs : attr ibuteGroup  ref="cns : dataTypeVersionDefinition"/> 
</ xs : complexType> 


<! —  TMATS  packets  --> 

<xs : complexType  name="TMATSDataType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 

<xs: element  name="IncludeFile"  type="xs : string"> 
<xs:annotation> 

<xs : documentation>I f  the  filename  is  relative  or  has 
no  path  at  all  it  should  be  relative  to  the  XML  file 

</ xs : documentation> 

</xs : anno tat ion > 

</ xs : element> 

<xs: group  ref="cns : RawDataGroup"  /> 

</xs : choice> 

</ xs : sequence> 

<xs : attribute  name="XML"  type="cns : TrueType"  /> 

<xs : attribute  name="Conf igChange"  type="cns : TrueType"  /> 

<xs : attr ibute  name="ChlOVersion"  type="cns : TMATSDataChlOVersionType"  /> 
<xs : attr ibute  name="CSDW"  type="cns :U32HexDec"  /> 

</ xs : complexType> 

<xs : simpleType  name="TMATSDataChlOVersionType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value=" 10 6-07 "  /> 

<xs : enumeration  value=" 10 6-09 "  /> 

<xs : enumeration  value=" 106-11 "  /> 

<xs : enumeration  value=" 10 6-13 "  /> 

<xs : enumeration  value=" 10 6-15 "  /> 

</xs:restriction> 

</xs : simpleType> 


<!--  CANBus  Packets  --> 

<xs : complexType  name="CANBusDataType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 

<xs : element  name="CANBusMessage" 
type="cns : CANBusMessageType"  /> 

<xs: group  ref="cns : RawDataGroup"  /> 

</xs : choice> 

</ xs : sequence> 

<xs : attribute  name="MessageCount"  type="cns :RelativeU24HexDec"  /> 
<xs : attribute  name="CSDW"  type="cns : U32HexDec"  /> 

</ xs : complexType> 


<xs : complexType  name="CANBusMessageType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 
<xs : group  ref="cns : RawDataGroup"  /> 

</xs : sequence> 


the  first 
is  used,  it 
sign  (+/-)  , 


<xs : attribute  name="RTC"  type="cns : RelativeU64HexDec"> 

<xs : annotation> 

<xs : documentation>This  is  used  as  a  64  bit  RTC  value,  i.e. 

16  bits  are  normally  filled  with  0.  If  RTC  attribute 
shall  take  precedence  over  date/time.  If  this  has  a 
then  this  is  interpreted  relative  to  the  packet  RTC 
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</ xs  :  documentation 
</xs:annotation> 

</xs : attribute> 

<xs : attributeGroup  ref="cns : secondaryHeaderTimeDefinition"  /> 

<xs : attribute  name="IPMessageHeader"  type="cns : U32HexDec"  /> 

<xs : attribute  name=" IPIDWord"  type="cns :U32HexDecNone"  /> 

<xs : attribute  name="DataError "  type="cns : TrueType"  /> 

<xs : attribute  name="FormatError "  type="cns : TrueType"  /> 

<xs : attribute  name="ExtendedIdentif ier "  type="cns : TrueType"  /> 

<xs : attribute  name="RemoteTransferRequest"  type="cns : TrueType"  /> 

<xs : attribute  name="CANBusID"  type="cns : U32HexDec"  /> 

<xs : attribute  name="Subchannel"  type="cns : U8HexDec"  /> 

<xs : attribute  name="LengthBytes "  type="cns : RelativeU8HexDec"  > 

<xs : annotation> 

<xs : documentation> 

The  length  attribute  includes  the  4  bytes  of  the 

Intra  packet  ID  word  per  CH10. 

</ xs : documentation> 

</xs:annotation> 

</xs : attribute> 

</ xs : complexType> 


<!--  Mill553  Packets  --> 

<xs : complexType  name="Mill553DataType"> 

<xs: sequence  minOccurs="0"  maxOccurs="unbounded"> 

<xs : choice> 

<xs : element  name="Mill553Message" 
type="cns :Mill553MessageType"  /> 

<xs: group  ref="cns : RawDataGroup"  /> 

</ xs : choice> 

</xs : sequence> 

<xs : attribute  name="MessageCount"  type="cns : RelativeU24HexDec"  /> 

<xs : attribute  name="TimeTagBits"  type="cns :Mill553TimeTagBitsType"  /> 
<xs : attribute  name="CSDW"  type="cns :U32HexDec"  /> 

</ xs : complexType> 

<xs : complexType  name="Mill553MessageType"> 

<xs: sequence  minOccurs="0"  maxOccurs="unbounded"> 

<xs: group  ref="cns : RawDataGroup"  /> 

</ xs : sequence> 


the  first 
is  used,  it 
sign  (+/-)  , 


<xs : attribute  name="RTC"  type="cns : RelativeU64HexDec"> 

<xs : annotation> 

<xs : documentation>This  is  used  as  a  64  bit  RTC  value,  i.e. 

16  bits  are  normally  filled  with  0.  If  RTC  attribute 
shall  take  precedence  over  date/time.  If  this  has  a 


then  this  is  interpreted  relative  to  the  packet  RTC 
</ xs : documentation> 

</ xs : annotation> 

</xs : attribute> 


<xs : attributeGroup  ref="cns : secondaryHeaderTimeDefinition"  /> 

<xs : attribute  name="BlockStatusWord"  type="cns : U1 6HexDec"  /> 
<xs : attribute  name="BusB"  type="cns : TrueType"  /> 

<xs : attribute  name="MessageError "  type="cns : TrueType"  /> 

<xs : attribute  name="RTRTTransfer"  type="cns : TrueType"  /> 
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<xs : attribute  name="FormatError "  type="cns : TrueType"  /> 

<xs : attribute  name="ResponseTimeOut"  type="cns : TrueType"  /> 
<xs : attribute  name="WordCountError "  type="cns : TrueType"  /> 
<xs : attribute  name="SyncTypeError "  type="cns : TrueType"  /> 

<xs : attribute  name=" InvalidWordError "  type="cns : TrueType"  /> 
<xs : attribute  name="GapTimel "  type="cns : U8HexDec"  /> 

<xs : attribute  name="GapTime2 "  type="cns : U8HexDec"  /> 

<xs : attribute  name="LengthBytes "  type="cns : RelativeUl 6HexDec" 
check  if  this  can  be  less  than  16  bits  --> 

</xs : complexType> 


/><! —  TODO 


<xs : simpleType  name="Mill553TimeTagBitsType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="Last  Bit  Of  Last  Word"  /> 

<xs : enumeration  value="First  Bit  Of  First  Word"  /> 
<xs : enumeration  value="Last  Bit  Of  First  Command"  /> 
</xs:restriction> 

</xs : simpleType> 


< ! —  ARINC42 9  Packets  — > 

<xs : complexType  name="ARINC429DataType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 

<xs : element  name="ARINC42 9Message" 
type="cns : ARINC429MessageType"  /> 

<xs: group  ref="cns : RawDataGroup"  /> 

</ xs : choice> 

</ xs : sequence> 

<xs : attribute  name="MessageCount"  type="cns : RelativeUl 6HexDec"  /> 

<xs : attribute  name="CSDW"  type="cns :U32HexDec"  /> 

</ xs : complexType> 

<xs : complexType  name="ARINC429MessageType"> 

<xs : attribute  name="IPDH"  type="cns :U32HexDec"  /> 

<xs : attribute  name="Subchannel"  type="cns : U8HexDec"  /> 

<xs : attribute  name=" FormatError "  type="cns : TrueType"  /> 

<xs : attribute  name="ParityError "  type="cns : TrueType"  /> 

<xs : attribute  name="HighSpeed"  type="cns : TrueType"  /> 

<xs : attribute  name="GapTime"  type="xs : unsignedlnt"  /> 

<xs : attribute  name="Raw32"  type="cns : U32HexDec"> 

<xs : annotation> 

<xs : documentation>The  raw  bits  including  the  parity. 

If  the  Raw31  attribute  is  given,  Raw32  shall  be 

ignored. 

The  state  of  the  ParityError  flag  is  not  influenced. 
</ xs : documentation> 

</xs:annotation> 

</xs : attribute> 

<xs : attribute  name="Raw31"  type="cns : U32HexDec"> 

<xs : annotation> 

<xs : documentation>The  raw  bits  excluding  the  parity. 

The  parity  bit  for  the  raw  bits  is  generated 
automatically  to  be  correct  unless  the  GenerateWrongPar ity  attribute  is  set  in  which 
case  the  parity  bit  is  generated  incorrect. 

If  the  Raw31  attribute  is  given,  Raw32  shall  be 

ignored. 

The  state  of  the  ParityError  flag  is  not  influenced. 
</ xs : documentation> 

</xs:annotation> 

</xs : attribute> 

<xs : attribute  name="GenerateWrongParity"  type="cns : TrueType"> 

<xs : annotation> 
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<xs : documentation^ f  this  is  set  a  wrong  parity  bit  is 
generated  to  the  raw  bits  defined  by  Raw31 . 

If  not  correct  parity  is  generated. 

If  Raw31  is  not  provided,  there  is  no  automatic 

handling  of  the  parity  bit. 

The  state  of  the  ParityError  flag  is  not  influenced. 
</ xs : documentation> 

</xs:annotation> 

</xs : attribute> 

</ xs : complexType> 


<!--  UART  Packets  --> 

<xs : complexType  name="UARTDataType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 

<xs : choice> 

<xs: element  name="UARTMessage"  type="cns : UARTMessageType" 

/> 

<xs: group  ref="cns : RawDataGroup"  /> 

</ xs : choice> 

</ xs : sequence> 

<xs : attribute  name="IPTS"  type="cns : TrueType"  /> 

<xs : attribute  name="CSDW"  type="cns :U32HexDec"  /> 

</ xs : complexType> 


<xs : complexType  name="UARTMessageType"> 

<xs: sequence  minOccurs="0"  maxOccur s="unbounded"> 
<xs: group  ref="cns :RawDataGroup"  /> 

</xs : sequence> 


<xs : attribute  name="RTC"  type="cns : RelativeU64HexDec"> 

<xs : annotation> 

<xs : documentation>This  is  used  as  a  64  bit  RTC  value,  i.e. 

the  first 

16  bits  are  normally  filled  with  0.  If  RTC  attribute 

is  used,  it 

shall  take  precedence  over  date/time.  If  this  has  a 

sign  (+/-), 

then  this  is  interpreted  relative  to  the  packet  RTC. 
If  neither  RawTime  not  RTC  nor  date/time  is  used,  the  IPH  is  left  out. 

</ xs : documentation> 

</ xs : annotation> 

</xs : attribute> 


<xs : attributeGroup  ref="cns : secondaryHeaderTimeDef inition"  /> 

<xs : attribute  name=" IDWord"  type="cns : U32HexDec"  /> 

<xs : attribute  name="Subchannel"  type="cns : U1 6HexDec"  /> 

<xs : attribute  name="ParityError "  type="cns : TrueType"  /> 

<xs : attribute  name="LengthBytes "  type="cns : RelativeUl 6HexDec"  /> 
<!--  TODO  filler  byte  corruption  settings  --> 

</xs : complexType> 


<!--  common  type  definitions  --> 

<xs: group  name="RawDataGroup"> 

<xs : choice> 

<xs:element  name="HexBytes"  type="cns : HexBytesType"  /> 
<xs:element  name="HexWords"  type="cns : HexWordsType"  /> 
<xs:element  name="HexLongWords"  type="cns : HexLongWordsType"  /> 
<xs:element  name="ASCII"  type="cns : ASCI IStr ingType"  /> 
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</ xs : choice> 

</ xs : group> 

<xs : attributeGroup  name="dataTypeDef inition"> 

<xs : attribute  name="DataTypeRaw"  type="cns : U8HexDec"/> 

<xs : attribute  name="DataType"  type="cns : DataTypeType"> 

<xs  :  annotationXxs  :  documentation>This  takes  precedence  over 
data_type_raw .  </xs  :  documentationx/xs  :  anno  tat  ion> 

</xs : attribute> 

</ xs : attributeGroup> 

<xs : attributeGroup  name="dataTypeVer sionDef inition"> 

<xs : attribute  name="DataTypeVer sionRaw"  type="cns : U8HexDec" /> 

<xs : attribute  name="DataTypeVersion"  type="cns : DataTypeVersionType"> 
<xs  :  annotationXxs  :  documentation>This  takes  precedence  over 
data_type_version_raw . </xs : documentationx/xs : annotation> 

</xs : attribute> 

</ xs : attributeGroup> 


<xs : attributeGroup  name="packetFlagsDef inition"> 

<xs : attribute  name="PacketFlags"  type="cns : U8HexDec"/> 

<xs : attribute  name="SecondaryHeader Present"  type="cns : TrueType" /> 
<xs : attribute  name="SecondaryHeaderTimeForIntraPacketTime" 
type="cns : TrueType"/> 

<xs : attribute  name="RTCSyncError "  type="cns : TrueType" /> 

<xs : attribute  name="DataOverf low"  type="cns : TrueType" /> 

<xs : attribute  name="SecondaryHeaderTimeFormat" 
type="cns : SecondaryHeaderTimeFormatType" /> 

<xs : attribute  name="ChecksumType"  type="cns : ChecksumTypeType" /> 

</ xs : attributeGroup> 


<xs : attributeGroup  name="secondaryHeaderTimeDef inition"> 

<xs : attribute  name="nsec"  type="xs : unsignedShort"  use="optional "  /> 

<xs : attribute  name="usec"  type="xs : unsignedShort"  use="optional "  /> 

<xs : attribute  name="msec"  type="xs : unsignedShort"  use="optional "  /> 

<xs : attribute  name="sec"  type="xs : unsignedByte"  use="optional "  /> 

<xs : attribute  name="min"  type="xs : unsignedByte"  use="optional "  /> 

<xs : attribute  name="hrs"  type="xs : unsignedByte"  use="optional "  /> 

<xs : attribute  name="day"  type="xs : unsignedByte"  use="optional "  /> 

<xs : attribute  name="mth"  type="xs : unsignedByte"  use="optional"> 

<xs : annotation> 

<xs : documentation>I f  this  attribute  is  used  and  no  ERTC  or 
RawTime,  a  IEEE-1588  time  is  created</xs : documentation> 

</ xs : annotation> 

</xs : attribute> 

<xs : attribute  name="year"  type="xs : unsignedShort"  use="optional "> 

<xs : annotation> 

<xs : documentation>I f  this  attribute  is  used  and  no  ERTC  or 
RawTime,  a  IEEE-1588  time  is  created</xs : documentation> 

</xs:annotation> 

</xs : attribute> 

<xs : attribute  name="ERTC"  type="xs : unsignedLong"> 

<xs : annotation> 

<xs : documentations f  this  attribute  is  used  it  takes 


precedence  over 
(including  positive  sign) 
packet  RTC  to  Ins 


date/time  but  not  RawTime.  Any  signed  numbers 

will  be 

relative  to  the  packet  RTC  (after  extending  the 

units) .  Numbers  without  sign  are  treated  absolute 
</ xs : documentation> 
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</xs:annotation> 

</xs : attribute> 

<xs : attribute  name="RawTime"  type="cns : U64Hex"> 

<xs : annotation> 

<xs : documentations f  this  attribute  is  used  it  takes 


precedence  over 

date/time  and  ERTC.  It  will  place  the  defined 
hexadecimal  value  into  the  8  time  bytes  (little  endian) 

</xs : documentation> 

</xs:annotation> 

</xs : attribute> 

</xs  :  attributeGroup> 


<xs : simpleType  name="ASCIIStringType"> 

<xs : annotation> 

<xs : documentation> 

This  represents  a  7-Bit  ASCII  encoded  string 
</xs : documentation> 

</xs:annotation> 

<xs : restriction  base="xs : string"> 

<xs : pattern  value="\p{ IsBasicLatin } * "/> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="HexBytesType"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  sequence  of  8  bit  hexadecimal  values 
separated  by  spaces.  The  values  are  stored  in  this  sequence  in  the  CH10  file.  The 
sequence  may  be  empty. 

</xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value=" ( [a-f A-F0- 9 ] { 2 } (  [a-fA-FO- 
9]  { 2  } ) *)  | "></xs : pattern> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="HexWordsType"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  sequence  of  16  bit  hexadecimal 
values  separated  by  spaces.  The  values  are  stored  in  this  sequence  in  the  CH10  file. 
When  storing  to  the  little  endian  CH10  file  each  value  will  be  byte  reversed.  The 
sequence  may  be  empty. 

</xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value=" ( [a-fA-FO-9] { 4 } (  [a-fA-FO- 
9]  { 4  } ) *)  | "></xs : pattern> 

</xs:restriction> 

</xs : simpleType> 

<xs : simpleType  name="HexLongWordsType"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  sequence  of  32  bit  hexadecimal 
values  separated  by  spaces.  The  values  are  stored  in  this  sequence  in  the  CH10  file. 
When  storing  to  the  little  endian  CH10  file  each  value  will  be  byte  reversed.  The 
sequence  may  be  empty. 

</xs : documentation> 

</xs:annotation> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value=" ( [a-fA-FO-9] { 8 } (  [a-fA-FO- 
9]  { 8  } ) *)  | "></xs : pattern> 
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</xs:  restrict:. on > 

</xs : simpleType> 

<xs : simpleType  name="TrueType"> 

<xs : annotation> 

<xs : documentation> 

This  type  is  used  for  attributes  that  just  have  two  states. 
The  false-state  is  indicated  by  omitting  the  attribute  at  all. 

</xs : documentation> 

</xs:annotation> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="True"/> 

</xs:restriction> 

</xs : simpleType> 

<xs : simpleType  name="NoneType"> 

<xs : restriction  base="xs : string"> 

<xs : enumeration  value="None"/> 

</xs:restriction> 

</ xs : simpleType> 


<xs : simpleType  name="RelativeU8HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  8  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  the  number  is  prefixed  with  Ox  and  decimal  otherwise.  The 
first  character  is  an  optional  +  or  -  to  indicate  that  the  number  shall  be  interpreted 
relative  to  something  (likely  a  calculated  auto  value) . 

</xs : documentation> 

</xs:annotation> 

<xs : restriction  base="xs : string"> 

<xs : pattern  value=" [\  +  \  —  ] ? (  (  [0  —  9]  {1,3})  |  (Ox [a-f A-F0- 
9] {1,2}) ) "></xs: pattern> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="RelativeU16HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  16  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  the  number  is  prefixed  with  Ox  and  decimal  otherwise.  The 
first  character  is  an  optional  +  or  -  to  indicate  that  the  number  shall  be  interpreted 
relative  to  something  (likely  a  calculated  auto  value) . 

</ xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs : pattern  value=" [\  +  \  —  ] ? (  (  [0—9]  {1,5})  |  (Ox [a-f A-F0- 
9] { 1 , 4 } ) ) "></xs : pattern> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="RelativeU24HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  24  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  the  number  is  prefixed  with  Ox  and  decimal  otherwise.  The 
first  character  is  an  optional  +  or  -  to  indicate  that  the  number  shall  be  interpreted 
relative  to  something  (likely  a  calculated  auto  value) . 

</xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 
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<xs : pattern  value=" [\  +  \  —  ] ?  (  ( [0—9]  {1,8})  |  (Ox [a-f A-F0- 
9] { 1 , 6 } ) ) "></xs : pattern> 

</xs:  restrict:. on> 

</ xs : simpleType> 

<xs : simpleType  name="RelativeU32HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  32  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  the  number  is  prefixed  with  Ox  and  decimal  otherwise.  The 
first  character  is  an  optional  +  or  -  to  indicate  that  the  number  shall  be  interpreted 
relative  to  something  (likely  a  calculated  auto  value) . 

</xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs: pattern  value=" [\+\-]?(([0-9]{l,10})| (0x[a-fA-F0- 
9] { 1 , 8 } ) ) "></xs : pattern> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="RelativeU64HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  64  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  the  number  is  prefixed  with  Ox  and  decimal  otherwise.  The 
first  character  is  an  optional  +  or  -  to  indicate  that  the  number  shall  be  interpreted 
relative  to  something  (likely  a  calculated  auto  value) . 

</ xs : documentation> 

</ xs : annotation> 

<xs : restriction  base="xs : string"> 

<xs : pattern  value=" [\  +  \  —  ] ? (  (  [0—9]  {1,20})  |  (Ox [a-fA-FO- 
9] { 1 , 1 6 } ) ) "></xs :pattern> 

</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="U8HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  8  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  it  is  prefixed  with  Ox  and  decimal  otherwise. 

</xs : documentation> 

</ xs : annotation> 

<xs: union  memberTypes="xs : unsignedByte  cns:U8Hex"  /> 

</ xs : simpleType> 

<xs : simpleType  name="U8Hex"> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value="0x [a-f A-FO-9 ] { 1 , 2 } "></xs : pattern> 
</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="U16HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  16  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  it  is  prefixed  with  Ox  and  decimal  otherwise. 

</xs : documentation> 

</ xs : annotation> 

<xs: union  memberTypes="xs : unsignedShort  cns:U16Hex"  /> 

</ xs : simpleType> 

<xs : simpleType  name="U16Hex"> 

<xs : restriction  base="xs : string"> 
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<xs:pattern  value="0x [a-f A-FO-9 ] { 1 , 4 } "></xs : pattern> 
</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="U32HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  32  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  it  is  prefixed  with  Ox  and  decimal  otherwise. 

</xs : documentation> 

</ xs : annotation> 

<xs: union  memberTypes="xs : unsignedlnt  cns:U32Hex"  /> 

</ xs : simpleType> 

<xs : simpleType  name="U32Hex"> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value="0x [a-f A-FO-9 ] { 1 , 8 } "></xs : pattern> 
</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="U64HexDec"> 

<xs : annotation> 

<xs : documentation> 

This  type  represents  a  64  bit  unsigned  integer  that  is 
interpreted  hexadecimal  if  it  is  prefixed  with  Ox  and  decimal  otherwise. 

</xs : documentation> 

</ xs : annotation> 

<xs: union  memberTypes="xs : unsignedLong  cns:U64Hex"  /> 

</ xs : simpleType> 

<xs : simpleType  name="U64Hex"> 

<xs : restriction  base="xs : string"> 

<xs:pattern  value="0x [a-f A-FO-9 ] { 1 , 1 6 } "></xs : pattern> 
</xs:restriction> 

</ xs : simpleType> 

<xs : simpleType  name="U32HexDecNone"> 

<xs : annotation> 

<xs : documentation> 

This  type  allows  the  definitions  like  in  U32HexDec  but  adds 
the  additional  state  "None"  that  is  used  to  completely  leave  the  32  bits  out 
</ xs : documentation> 

</ xs : annotation> 

<xs:union  memberTypes="cns : NoneType  cns : U32HexDec"  /> 

</ xs : simpleType> 

</ xs : schema> 
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